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Sobre o autor 


Por que decidi escrever sobre o Redmine? 


Olá, meu nome é Patrick Kaminski, sou especialista em segurança 
de sistemas e atuo na área de TI como desenvolvedor, palestrante, 
consultor e professor. 


Primeiramente gostaria de contar um pouco sobre minha vida na 
área de Tl e como foi o meu primeiro contato com o Redmine para 
que você me conheça melhor. 


Desde muito cedo acabei por me interessar por programação, e com 
o passar do tempo meu interesse por desenvolvimento web se 
destacou. Comecei a trabalhar com PHP e outras tecnologias por 
volta de 2004. Acabei trabalhando profissionalmente com esta e 
outras linguagens, quando começou a ficar complicado demais 
organizar os projetos com os seus prazos apertados e recursos 
escassos. Quando falo recursos, o mais precioso neste caso era o 
tempo. 


Então começamos (neste cenário estávamos eu e outros 
profissionais da empresa onde eu trabalhava na época) a pesquisar 
ferramentas que atendessem às necessidades que possuíamos na 
época. Procuramos inicialmente por ferramentas baseadas na 
filosofia do software livre, pois tínhamos o desejo de querer adaptar 
a ferramenta às nossas necessidades caso fosse preciso. 


Realizamos vários testes com algumas ferramentas, a maioria nos 
atendia, porém, não totalmente. Foi então que encontrei o Redmine, 
um sistema que prometia gerenciar projetos de forma ágil, porém, 
não acreditei muito de início por se tratar de algo desenvolvido com 
Ruby on Rails. Aos desenvolvedores Ruby, e demais, devo aqui 
uma explicação... 


Nessa época (meados de 2009) em que eu conheci o Redmine, o 
Ruby on Rails estava começando a surgir em todos os sites da web 


como sendo o framework do futuro. Com isso, grande parte dos 
desenvolvedores lia sobre o Rails, se interessava e passava a focar 
os seus esforços em aprender a nova tecnologia. Eu, ao contrário 
da tendência, decidi manter o meu foco no PHP, e tudo que eu via 
relacionado ao Rails eu encarava como algo passageiro assim como 
o Rails, e mantive a minha atenção ao bom e velho PHP, 
companheiro de guerra. 


Mas como estávamos precisando de uma ferramenta, decidi usar 
um dia inteiro para instalar e configurar em um servidor interno o 
Redmine, e foi então que eu passei a acreditar um pouco no tal do 
Ruby on Rails - pois digo com todas as palavras que aquele monte 
de códigos estranhos e pouco semelhantes ao PHP me 
surpreenderam. O Redmine funcionou melhor do que eu esperava, 
e passei a indicá-lo para outras pessoas. Em setembro de 2009, 
decidi criar um grupo de usuários para o Redmine no Brasil 
(Redmine Brasil), e que na minha opinião está funcionando muito 
bem, e superou minhas expectativas. 


Alguns anos se passaram e passei a trabalhar profissionalmente 
com o Redmine, prestando consultorias e palestras sobre a 
ferramenta, então decidi agrupar todo o meu conhecimento nele 
para criar um livro para você e para qualquer pessoa que queira 
melhorar a organização dos seus projetos, assim como eu quis em 
2009. Espero que você goste! 


Introdução 


Quero que você responda mentalmente à primeira pergunta deste 
livro. 


Onde está a documentação do primeiro projeto em que você 
trabalhou? 


Se você respondeu a esta questão com muita facilidade, recomendo 
pular para a seção Meus projetos estão bem organizados! desta 
Introdução. Caso contrário, você faz parte da grande maioria. 
Prossiga... 


TODOS os profissionais, possuem uma função fundamental no seu 
dia a dia: resolver problemas. 


E, infelizmente, boa parte destes profissionais iniciou suas carreiras 
como resolvedores de problemas da pior maneira possível: 


— Bom dia! Aqui está um dos problemas de hoje! Você é pago para 
resolvê-lo! 


Desta forma, fomos treinados para fazer antes de planejar. Por isso 
é que muitos dos projetos acabam tomando mais tempo e recursos 
do que de fato deveriam, pois não pensamos claramente sobre 
todas as etapas necessárias para alcançar a solução ideal. Isso 
acaba por fazer com que muitos profissionais fiquem desanimados 
ao fim do dia por causa da pouca produtividade. 


Então o que sugiro a partir de agora é que você se torne um 
resolvedor de problemas de alto nível, independente da sua área de 
atuação. Revise seus projetos atuais e busque ao final desse livro 
dizer para você mesmo... 


Meus projetos estão bem organizados! 


O objetivo deste livro é apresentar a você algumas formas de 
manter os seus projetos organizados de forma ágil, utilizando o 


sistema de gerenciamento de projetos Redmine. 


Para um melhor entendimento, sugiro a utilização prática do 
Redmine em paralelo à leitura deste livro. Para facilitar, realize a 
instalação em uma máquina local utilizando um instalador 
automatizado como o Bitnami (https://bitnami.com/stack/redminey/). 
No capítulo Preparando o ambiente há um passo a passo de como 
fazer isso. Mas também vou apresentar outros tipos de instalação 
do Redmine, para você saber quando optar ou não por este tipo de 
instalação automática. 


O que é Redmine e por que usá-lo? 


Em resumo, o Redmine é uma ferramenta web para gerenciamento 
de projetos. 


Mas, além disso, é importante saber que ele é um software livre 
disponibilizado livremente na internet através da licença aberta GPL 
v2 (GNU General Public License v2), criado em 2006 pelo francês 
Jean-Philippe Lang, utilizando como base o framework MVC Ruby 
on Rails. 


Isso fez com que o Redmine pudesse ser utilizado por qualquer 
pessoa gratuitamente além de permitir a modificação e 
redistribuição. Essa é uma das características principais que 
possibilitou a utilização do Redmine em vários países por diversas 
empresas e pessoas, pois qualquer um com um pouco de 
conhecimento pode baixá-lo e utilizá-lo. Desta forma ele conquistou 
um grande número de usuários, influenciando também a criação 
deste livro. 


Graças a isso, o Redmine chegou também ao Brasil, onde muitas 
empresas de diferentes ramos, estão escolhendo o Redmine como 
ferramenta para melhorar os seus processos e inclusive para 
alcançar certificações. 


Vamos utilizar exemplos práticos, que se assemelhem aos principais 
tipos de situações encontradas no dia a dia. Veremos como a 
atividade de gerenciar projetos será simples com o Redmine, 
independente da metodologia adotada, explorando suas 
funcionalidades, com base nas versões 3 e 4. 


# Público-alvo 


Este livro é recomendado para usuários iniciante do Redmine, 
gerente de projetos, e gerente de redes responsáveis por prestar 
manutenção ao Redmine. Não é necessário conhecimento técnico 
avançado para a utilização do Redmine ou para ler este livro. 


Grupo de discussão 


Recomendo também, que você participe do grupo Redmine Brasil, 
no Google Groups. É só acessar o endereço 
http://bit.ly/RedmineBR/. Ele está ativo desde 2009, e você será 
muito bem-vindo para trocar conhecimentos e sanar dúvidas. Te 
esperamos lá! 


Tornando-se um especialista em Redmine 


Para auxiliar na fixação do conteúdo, em algumas partes do livro 
haverá um QR Code específico que poderá ser acessado através do 
celular, seguido de um link para ser acessado também pelo 
computador. 


Desta forma, você poderá validar o que aprendeu em cada parte do 
livro acompanhando o seu desempenho até se tornar um 
especialista em Redmine. 


Fórum 


Caso queira conversar comigo e com leitores deste livro, temos um 
espaço disponível no fórum da Casa do Código: 
http://forum.casadocodigo.com.br/. 


GitH ub 


Alguns dos exemplos citados neste livro estão disponíveis no 
GitHub através do seguinte endereço: 
https://github.com/RedmineBR/ 


Caso queira contribuir com algo no GitHub, pode entrar em contato 
comigo! 


Falando nisso, para entrar em contato, basta acessar o seguinte 
endereço: http://patrickkaminski.com/contato 


Seu feedback é muito importante! 


Parte A: Conhecendo o 
Redmine 


CAPÍTULO 1 
Primeiros passos 


1.1 Mina Vermelha Sistemas 


Para facilitar o entendimento da melhor maneira possível, vamos 
usar como exemplo uma empresa fictícia especializada no 
desenvolvimento de softwares chamada Mina Vermelha Sistemas 
LTDA. 


A Mina Vermelha Sistemas se trata de uma empresa que conseguiu 
se destacar no seu ramo e que hoje completa 10 anos de existência. 
Muita coisa aconteceu e atualmente a Mina Vermelha possui mais 
de 1.000 clientes que pagam mensalmente pelos seus serviços e 
que solicitam suporte constantemente. 


Todas as solicitações são atendidas pela equipe de suporte, que 
tenta resolver de forma imediata, ou então solicita apoio das equipes 
de desenvolvimento ou de infraestrutura, dependendo da situação. 


Todo o controle acontece através de e-mails, e em alguns casos 
raros através de um sistema criado 8 anos atrás, por um ex- 
funcionário quando a empresa estava surgindo. 


Devido à grande demanda de suporte e ao objetivo de oferecer 
melhores serviços, a empresa acabou encontrando o Redmine 
depois de algumas buscas na internet e está tentando adaptá-lo ao 
seu cenário. 


Nos capítulos a seguir, vamos utilizar o cenário da Mina Vermelha 
como base para nossos exemplos. 


1.2 Preparando o ambiente 


Antes de prosseguirmos, vamos adotar alguns requisitos básicos 
para você explorar os principais recursos do Redmine. Como 
comentei na Introdução deste livro, para facilitar o processo, vamos 
utilizar inicialmente uma instalação automatizada do Redmine 
apenas para conhecer suas funcionalidades principais. No capítulo 
4. Instalando o Redmine manualmente veremos como instalá-lo 
manualmente para entender o funcionamento por meio de cada um 
de seus componentes. 


Caso você já possua uma instalação do Redmine em funcionamento 
com permissões de administrador, pode avançar direto para o 
capítulo 6. O que é um projeto e como gerenciá-los no Redmine. 


Obtendo o Redmine 


O primeiro passo para instalar é realizar o download de acordo com 
o seu sistema operacional no seguinte link: 


https://bitnami.com/stack/redmine/installer/ 


Ao acessar esse link, selecione o seu sistema operacional e baixe a 
versão mais recente. Ao clicar, aparecerá uma tela sugerindo que 
você crie uma conta no site Bitnami, porém, não é necessário. Se 
não quiser criar uma conta, basta clicar no link: No thanks, just take 
me to the download. Após concluído, execute o arquivo para iniciar 
a instalação. 


Instalação no Windows 


No caso do Windows, ao iniciar a instalação, será solicitado que 
você escolha idioma de sua preferência. Este servirá apenas para o 
processo de instalação. Como não existe a opção português na 
instalação, as imagens a seguir estão em inglês. 


Na maioria das telas da instalação, basta clicar em Next para 
prosseguir. Em outras é importante a atenção quanto a alguns 
detalhes, por isso, observe as imagens a seguir em paralelo ao seu 
processo: 


F Setup — o x 


+o 
q» 
na 


Select Components 


Select the components you want to install; dear the components you do not want to install. Click 
Next when you are ready to continue. 

DevkKit Click on a component to get a detailed description 
PhpMyAdmin 
Redmine 

Git 














InstallBuilder 
< Back Next > Cancel 








Figura 1.1: Nesta tela você pode escolher o que quer instalar junto com o Redmine. Como 
padrão, todos os itens estão marcados. Falaremos sobre estes itens opcionais mais 
adiante. 





f Setup — o x 


Installation folder 





Please, choose a folder to install Bitnami Redmine Stack 
Select a folder |C:\Bitnami\redmine-3.4.6-3 po 





InstallBuilder 








Figura 1.2: Você pode escolher uma pasta específica para realizar a instalação. É 
importante alterar caso haja mais de uma instalação. 





f Setup = oO x 


Create Admin account + 





Bitnami Redmine Stack admin user creation 








Your real name Gerente dos Projetos 
Email Address seu@email.com 
Login gerente 

Password messes 





InstallBuilder 








Figura 1.3: Para que você possa utilizar o Redmine, é necessário criar um usuário 
administrador. Lembre-se do usuário e senha, pois sem eles você não terá acesso ao 
sistema! 





£*% Setup — o x 


Web Server Port 





Please enter the port that the bundled Apache Server will listen to by default. 
Apache Web Server Port |80 





InstallBuilder 








Figura 1.4: Como padrão o Redmine utilizará a porta 80 para acesso através do Apache. 
£*% Warning x 


Unable to bind to the given port number. This port is already in use by 
"Skype.exe" process. Please select another Apache Server Port.Please select 


another Apache Server Port. 


Figura 1.5: Caso haja alguma outra aplicação utilizando a porta 80 como Skype ou outra 
instalação do Apache, você precisará informar outra porta para acesso. 











£*% Setup — o x 


Web Server Port 





Please enter the port that the bundled Apache Server will use for SSL access. 
SSL Port | 443 





InstallBuilder 








Figura 1.6: O Redmine terá disponível também um acesso HTTPS, como padrão ele 
utilizará a porta 443. 


£*% Warning x 
i Unable to bind to the given port number. This port is already in use by 


"Skype.exe" process. Please select another Apache HTTPS Server Port.Please 
select another Apache HTTPS Server Port. 


L œ] 


Figura 1.7: A porta também pode ser mudada caso ocorra algum conflito com outro serviço. 








Na próxima tela, selecione o idioma que a sua aplicação deverá 
utilizar. Poderá ser alterado posteriormente, porém, é interessante 
deixar em Português do Brasil, pois a instalação já cadastrará 
algumas informações de acordo com o idioma selecionado. 


fù Setup — O x 
e 
Configure SMTP Settings X e 


This is required so your application can send notifications via email. 


PUIIOO CLAN CO NE OO CA OU CAM CORA LAN CAM MAO CEN OC Ma SOM USA an aan Rasa sas ssa n sons san cenas sandas 


Default email provider: GMail v 


InstallBuilder 


< Back Next > Cancel 








Figura 1.8: Você poderá adicionar suporte ao envio de notificações por e-mail. Neste caso 
você pode configurar uma conta do Gmail/Google for Work ou então outra conta de e-mail. 
E importante que esta conta seja utilizada apenas pelo Redmine. 





f Setup — o x 


Configure SMTP Settings 





This data is stored in the application configuration files and may be visible to others. For this 
reason, itis recommended that you do not use your personal account credentials. 





InstallBuilder 








Figura 1.9: No caso de optar por utilizar uma conta do Gmail ou Google for Work informe os 
dados de autenticação do usuário do Google. 





fù Setup = O x 


Configure SMTP Settings 


This data is stored in the application configuration files and may be visible to others. For this 
reason, it is recommended that you do not use your personal account credentials. 


Username usuario 

Password RR 

Re-enter EEEE 

SMTP Host smtp.servidordeemail.com 

SMTP Port 587 

Secure connection TLS “e 
InstallBuilder 








Figura 1.10: Caso opte por utilizar uma conta que não seja do Google, é necessário 
informar os dados do servidor SMTP para autenticação. 


Geralmente, a instalação demora um pouco, pois serão instalados 
diversos itens e serão realizadas diversas configurações no seu 
sistema operacional. 


Ao finalizar a instalação, o Redmine será inicializado 
automaticamente. 


(2) Bitnami Redmine Stack 3.4.6-3 — xX 
Welcome Manage Servers Server Events 


Welcome to Bitnami Redmine Stack 3.4.6 
Rev. 3 








La GO tO Application 








Follow Bitnami l Open phpMyAdmin 
Open Application Folder 
e + 


Visit Bitnami 
Get Support 
Figura 1.11: Neste caso, abrirá automaticamente o Bitnami Redmine Stack Manager Tool. 
Ele estará também disponível através do menu Iniciar. 
































12) Bitnami Redmine Stack 3.4.6-3 — x 


Welcome Manage Servers Server Events 





Server Status 
O MySQL Database Running Start 
O Apache Web Server Running Stop 
O Thin redmine Running Restart 
2 Thin redmine2 Running 
Configure 











Start All Stop All Restart All 


Figura 1.12: Através da aba Manage Servers será possível gerenciar os serviços 
relacionados ao Redmine, falaremos mais sobre eles em breve. 


1.3 Acessando o Redmine pela primeira vez 


Após realizar a instalação e iniciá-lo, o Redmine funcionará como 
um servidor web, onde você poderá acessá-lo localmente ou em 
rede, dependendo das suas configurações. Para isto, basta iniciar o 
navegador web de sua preferência e acessar o seguinte endereço: 


http:/localhost/ 


Caso você tenha selecionado outra porta diferente da porta 80 ao 
instalar, acesse informando a porta após o localhost utilizando o 


sinal de dois pontos ( : ). Exemplo no caso de ter escolhido a porta 
123: 


http:/localhost:123/ 


Para acessar remotamente através da rede, basta substituir a 
palavra localhost pelo endereço IP correspondente ao servidor em 
que o Redmine estiver instalado. 


Página inicial Projetos Ajuda Entrar Cadastre-se 


Redmine eusca: ES 





Usuário 


Senha Perdi minha senha 











Entrar 


Figura 1.13: Ao acessar, será exibida a página inicial do Redmine. Clique em Entrar para 
informar o seu usuário e senha. 


Após realizar o acesso, você terá alguns itens do menu à disposição 
para acompanhar e entender cada uma das funcionalidades 
existentes no Redmine! 


Conclusão 


Agora que você sabe como acessar o seu Redmine, procure utilizá- 
lo em conjunto com este livro para explorar todas as funcionalidades 
de maneira mais produtiva. 


CAPÍTULO 2 
Conhecendo a estrutura 


Como vimos nos capítulos anteriores, existem ferramentas que 
facilitam o processo de instalação do Redmine. Mas é importante 
conhecer a arquitetura de funcionamento, para ajustes posteriores. 
No caso da instalação do Bitnami, o pacote do Redmine já vem com 
tudo pronto e configurado, tentando atender a maioria dos cenários, 
porém, para entender o que já foi feito, vamos explorar melhor os 
itens essenciais do Redmine. 


Basicamente, para que o Redmine funcione corretamente é 
necessária a existência itens a seguir: 


2.1 Ruby e Ruby on Rails 


Já comentamos na introdução deste livro que o Redmine se trata de 
um sistema desenvolvido utilizando o framework Ruby on Rails. Por 
este fato, tanto o Ruby, como o Ruby on Rails fazem parte dos 
requisitos essenciais para o funcionamento do Redmine. 


A seguir, temos uma relação das versões necessárias de ambos de 
acordo com a versão do Redmine: 


Versão do Redmine Ruby Rails 
4.0 2.2, 2.3, 2.4 ou 2.5 5.2 
3.4 1.9.3, 2.0.0, 2.1, 2.2, 2.3 ou 2.4 4.2 
3.3 1.9.3, 2.0.0, 2.1, 2.2 ou 2.3 4.2 


3.2 1.9.3, 2.0.0, 2.1 ou 2.2 4.2 


Como neste livro estamos focando nas versões iguais ou superiores 
a 3e 4 do Redmine, você pode optar por uma das versões 
correspondentes do Ruby e do Rails de acordo com a sua. 


Para realizar a instalação do Ruby existem várias formas, descritas 
na documentação do site oficial: https://www.ruby-lang.org/. Vamos 
conferir algumas. 


Instaladores 


Uma das formas mais simples de instalar no Windows e no Mac é 
através do Raillnstaller, com a qual basta baixar o instalador através 
do site http://railsinstaller.org/. 


Ele possui uma interface muito intuitiva. Basta clicar em Next, Install 
e Finish, que ele instalará o Ruby e também o framework Ruby on 
Rails e deixará tudo configurado no seu computador. 


Sistemas gerenciadores de pacotes 


Já em alguns sistemas como o Linux, por exemplo, é possível 
realizar a instalação através de gerenciadores de pacotes através 
dos comandos a seguir: 


Apt-get (Debian, Ubuntu e derivados): 


$ sudo apt-get install ruby-full 


Yum (Fedora, RHEL, CentOS e derivados): 


$ sudo yum install ruby-full 


Homebrew (OS X): 


$ brew install ruby 


2.2 Testando a instalação do Ruby 


Para verificar se a instalação ocorreu corretamente, basta acessar o 
terminal ( cmd ) e executar o seguinte comandos para verificar a 
versão do Ruby: 


ruby -v 


Caso o comando retorne a versão do Ruby, significa que foi 
instalado corretamente. Caso não tenha utilizado o Railsinstaller, é 
necessário realizar a instalação do Ruby on Rails, utilizando o 
seguinte comando: 


gem install rails 


Para especificar a versão, é possível utilizar o parâmetro -v, como 
no exemplo a seguir: 


gem install rails -v 5.2.1 


E para validar a instalação do Rails, basta utilizar o seguinte 
comando: 


rails -v 


Desta forma, dois dos principais requisitos já estarão atendidos. 


2.3 Servidor web 


Apache HTTP 


Ao realizar a instalação do Redmine através do instalador do 
Bitnami, é realizada também a instalação do servidor web Apache 
HTTP. Ele não é necessário no caso de instalações manuais, pois o 
Redmine não depende dele para funcionar. 


Porém, o Apache pode auxiliar no processo de gerenciamento, 
servindo como uma camada adicional. Isso possibilita que o 
Redmine seja executado com mais de um servidor web, enquanto o 


Apache faz o balanceamento entre eles, de modo que o Redmine 
continue disponível caso um deles fique indisponível. 


É assim que a instalação do Bitnami, fazendo com que o Apache 
realize o balanceamento entre duas instâncias do servidor web 
Thin, como é demonstrado na imagem a seguir. 


Thin 
Porta 3003 


e 
S Y 
D ma 





Apache HTTP 
Porta 80 
Thin 

Porta 3004 





Figura 2.1: Funcionamento do Redmine com o Apache. 
Thin e outras opções 


Na prática, quem interpreta o Ruby e exerce a função de servidor 
web na maioria das instalações atuais do Redmine é geralmente o 
servidor Thin. 


Além do Thin, existem outras opções de servidores web capazes de 
interpretar o Ruby, como: 


e Puma: http://puma.io 
e Unicorn: https://bogomips.org/unicorn 
e Webrick: https://github.com/ruby/webrick 


e Phusion Passenger: https://www.phusionpassenger.com 


Todas estas opções apresentam funcionamento semelhante ao 
Thin, por isso não serão detalhadas. O Thin apresenta desempenho 
superior e é mais utilizado que os demais, inclusive sendo o 
escolhido pela equipe do Bitnami. 


2.4 Banco de dados 


Outro item essencial para o funcionamento do Redmine é o banco 
de dados. Ele é que servirá para armazenar todas as informações 
do sistema. 


O Redmine pode utilizar os seguintes bancos de dados: 


Banco de dados Versão necessária Adapter 
MariaDB 5.5 ou superior mysql2 
MySQL 5.5 ou superior mysql2 
Microsoft SQL Server 2012 ou superior sqlserver 
PostgreSQL 8.3 ou superior postgresql 
SQLite 3 sqlite3 


No capítulo a seguir, vamos utilizar o MySQL como base de dados, 
porém, nada impede você de realizar a instalação utilizando outro 
banco de dados suportado. A escolha dependerá mais da sua 
preferência e de seus conhecimentos do banco de dados. 


Conclusão 


Com isso, temos os itens essenciais para o funcionamento do 
Redmine, e no próximo capítulo veremos como utilizar esta estrutura 
para instalar o Redmine com Docker. 


CAPÍTULO 3 
Instalando o Redmine com o Docker 


Uma outra forma interessante de realizar a instalação do Redmine é 
através do Docker. Se você não sabe o que é Docker, saiba que a 
sua utilização vem se tornando um padrão para a execução de 
aplicações de rede nos últimos anos. 


Basicamente, a ideia é que as aplicações sejam executadas em 
ambientes isolados da máquina principal. Estes ambientes recebem 
o nome de containers (contêineres) e seu desempenho tende a ser 
superior a virtualizações, além de permitir um melhor gerenciamento 
de recursos, aumentando a produtividade da equipe e reduzindo 
custos. 


3.1 Instalando o Docker 


O primeiro passo para utilizar o Docker é instalá-lo através do site 
oficial: https://www.docker.com/. 


Utilize o instalador de acordo com o seu sistema operacional. A 
instalação é simples, basta seguir as instruções e o Docker deverá 
funcionar no seu computador. 


Após realizar a instalação, você terá à disposição os comandos 
docker @ docker-compose através do terminal. 


Para conferir se o Docker foi instalado corretamente, é possível 
testar com a criação de uma aplicação de testes: 


docker run hello-world 


Se estiver tudo certo, o comando retornará algo semelhante ao texto 
a seguir: 


docker run hello-world 


Unable to find image 'hello-world:latest' locally 

latest: Pulling from library/hello-world 

ca4f61b1923c: Pull complete 

Digest: 

sha256: cadeeb6fbO5351dfc8759c20733c91def84cb8007aa89ab5bf606bc8b315b9fc7 
Status: Downloaded newer image for hello-world: latest 


Hello from Docker! 
This message shows that your installation appears to be working correctly. 


Neste exemplo, o Docker baixou a aplicação hello-world do 
repositório Docker Hub (https://hub.docker.com/ /hello-world/), e a 
executou com sucesso. 


Já para iniciar uma instância do Redmine através do Docker, é 
possível utilizar uma das imagens oficiais disponibilizadas no Docker 
Hub. No seguinte link temos uma lista de imagens e opções de 
como instalar o Redmine utilizando o Docker: 
https://hub.docker.com/ /redmine/ 


Estes contêineres realizam a instalação de todas as dependências, 
incluindo o Ruby on Rails e o banco de dados. 


Em resumo, ao executar o comando docker run redmine, O Docker 
buscará as informações no Docker Hub para saber como responder 
à solicitação. 


Veremos a seguir quais as configurações que precisamos utilizar 
para iniciar o Redmine com o Docker. 


3.2 Redmine através do comando docker 


Através do comando docker será possível criar o ambiente 
necessário para a execução do Redmine, escolhendo o banco de 


dados: 


Docker com PostgreSQL 


docker run -d --name some-postgres -e POSTGRES PASSWORD=secret -e 
POSTGRES USER=redmine postgres 
docker run -d --name some-redmine --link some-postgres:postgres redmine 


Docker com MySQL 


docker run -d --name some-mysql -e MYSQL ROOT PASSWORD=secret -e 
MYSQL DATABASE=redmine mysql 
docker run -d --name some-redmine --link some-mysql:mysql redmine 


Independente do banco de dados escolhido, o comportamento será 
semelhante. As imagens do PostgreSQL, MySQL e Redmine serão 
baixadas através do Docker Hub e já farão com que o Docker 
realize os processos de instalação e configurações. Em poucos 
minutos, o Redmine estará pronto para ser utilizado. 


A maioria das configurações básicas para que os serviços 
funcionem já estão predefinidas nas imagens armazenadas no 
Docker Hub. Apenas precisamos definir algumas configurações 
adicionais através do parâmetro -e: 


Variável Função 
POSTGRES PASSWORD Senha do PostgreSQL 
POSTGRES USER Usuário do PostgreSQL 


MYSQL ROOT PASSWORD Senha do MySQL 


MYSQL DATABASE Nome da base de dados do MySQL 


3.3 Redmine através do comando docker- 
compose 


Já no caso do comando docker-compose , é necessária a criação de 
um arquivo contendo as configurações desejadas. Esta é uma 
opção interessante quando existem várias aplicações utilizando o 
Docker, e é necessário gerenciar estes serviços em paralelo. Neste 
caso, as configurações utilizadas no comando docker run são 
armazenadas em um arquivo, facilitando o gerenciamento. 


Para utilizar o Redmine com MySQL, crie um arquivo chamado 
docker-compose.yml COM O seguinte conteúdo: 


version: '3.1' 
services: 
redmine: 
image: redmine 
restart: always 
ports: 
- 80:3000 
environment: 
REDMINE DB MYSQL: db 
REDMINE DB PASSWORD: senhasecreta 
REDMINE DB DATABASE: redmine 
db: 
image: mysql:5.7 
restart: always 
environment: 
MYSQL ROOT PASSWORD: senhasecreta 
MYSQL DATABASE: redmine 


Caso opte pelo PostgreSQL em vez do MySQL, basta utilizar o 
seguinte conteúdo: 


version: '3.1' 
services: 
redmine: 
image: redmine 
restart: always 
ports: 
- 80:3000 
environment: 


REDMINE DB POSTGRES: db 
REDMINE DB PASSWORD: senhasecreta 
REDMINE DB DATABASE: redmine 
db: 

image: postgres 

restart: always 

environment: 
POSTGRES PASSWORD: senhasecreta 
POSTGRES DB: redmine 


E então execute o seguinte comando através do terminal no 
diretório em que o arquivo se encontra: 


docker-compose up -d 


Ao executar este comando, serão realizados o download, instalação 
e configuração do banco de dados e do Redmine. Após ser 
instalado, o Redmine ficará acessível através da porta local 80. 
Caso você queira alterar a porta externa para outra (8080, no nosso 
exemplo), basta modificar o seguinte trecho do arquivo: 


ports: 
- 8080:3000 


Conclusão 


Esta é uma maneira alternativa de realizar a instalação do Redmine, 
aproveitando-se da estrutura oferecida pelo Docker. No caso de 
equipes que já utilizem os conceitos de contêineres e 
microsserviços, torna-se natural fazer uso do Redmine também 
como um contêiner. Já no caso de equipes que ainda não utilizam o 
Docker, é interessante analisar primeiramente se existem mais 
serviços que podem aproveitar esta mesma estrutura. 


CAPÍTULO 4 
Instalando o Redmine manualmente 


Este capítulo apresenta uma alternativa ao processo de instalação 
automática apresentado no capítulo 1. Primeiros passos. E é 
dedicado a quem deseja botar a mão na massa e instalar por conta 
própria cada um dos componentes do Redmine para entender 
melhor como ele funciona. Se este não for o seu desejo, pode 
continuar utilizando a sua instalação inicial e seguir para o próximo 
capítulo! 


Boa parte dos passos a seguir exigirão a execução de comandos 
através do terminal, independente do seu sistema operacional. Além 
disso, será necessário conhecimento básico em gerenciamento de 
banco de dados. 


4.1 Instalação 


Para realizar a instalação do Redmine, após instalar os programas 
essenciais apresentados nos capítulos anteriores (Ruby, Rails, 
servidor web e sistema de banco de dados), precisamos realizar o 
download da versão desejada através do endereço a seguir: 


http://www.redmine.org/projects/redmine/wiki/Download/ 


Procure optar pela versão estável mais recente. Após realizar o 
download do arquivo correspondente, descompacte-o no diretório de 
sua preferência, e acesse o diretório extraído através do terminal 
para realizar os próximos passos. 


Dependências 


Para controle de dependências, o Redmine utiliza o Bundler. Para 
instalá-lo basta executar o seguinte comando através do terminal: 


gem install bundler 
Permissões de escrita 


Para que o Redmine consiga armazenar anexos, logs, entre outras 
informações, precisamos fornecer permissões de escrita a alguns 
diretórios para o usuário do Redmine, caso o sistema operacional 
não seja Windows. Os seguintes diretórios necessitam de 
permissões de escrita: 


e files: armazenamento de anexos 

e log: armazenamento de logs 

e tmp: armazenamento de arquivos temporários 

e public/plugin assets: armazenamento de itens gerados por 
plugins 


Basta executar os seguintes comandos para que os diretórios 
tenham permissões de escrita para o usuário redmine: 


sudo chown -R redmine:redmine files log tmp public/plugin assets 
sudo chmod -R 755 files log tmp public/plugin assets 


Altere o primeiro comando caso utilize outro usuário para a 
execução do Redmine, como no exemplo a seguir: 


sudo chown -R outrouruario files log tmp public/plugin assets 
Gerando chave secreta de sessões 


Por questões de segurança, é necessário executar o comando a 
seguir para que o Ruby on Rails gere cookies codificados, 
impedindo a adulteração de arquivos de sessão. 


bundle exec rake generate secret token 


Criando o banco de dados 


Para que o Redmine consiga armazenar as informações, 
precisamos criar a estrutura inicial do banco de dados, e configurar 
o acesso a ele. 


O primeiro passo é acessar o sistema de banco de dados e criar 
uma nova base. No caso do MySQL, basta executar o seguinte 
comando SQL: 


CREATE DATABASE redmine 


O segundo passo é a criação de um usuário contendo as 
permissões necessárias para realizar alterações nesta nova base de 
dados. A seguir temos um exemplo de comando SQL em que 
criamos o usuário reduser com a palavra senhadificil como senha. 


CREATE USER 'reduser'@'%' IDENTIFIED BY 'senhadificil'; 
GRANT ALL PRIVILEGES ON `redmine`.* TO 'reduser'(0'%' WITH GRANT OPTION; 


Depois de realizar a criação da base de dados e do usuário, 
precisamos alterar o arquivo de configuração localizado no seguinte 
caminho: htdocs/config/database.yml 


Nesse arquivo é que estão armazenadas as informações de 
conexão ao banco de dados do Redmine. A seguir temos um 
exemplo de configuração em que o Redmine utiliza um servidor 
MySQL, localizado no endereço 127.0.0.1: 


production: 
adapter: mysql2 
database: redmine 
host: 127.0.0.1 
username: reduser 
password: senhadificil 
port: 3307 


Após ajustar as configurações com as informações de autenticação 
ao banco de dados, o Redmine pode criar a estrutura de tabelas e 
registros essenciais para o seu funcionamento. 


Instalando 


Após ajustar as configurações básicas, execute o comando a seguir 
para que o Redmine seja instalado, juntamente com todas as suas 
dependências: 


bundle install --without development test rmagick 


E então, crie a estrutura do banco de dados com o seguinte 
comando: 


RAILS ENV=production bundle exec rake db:migrate 


A sintaxe do comando muda pouca coisa no caso de sistemas 
Windows, onde temos que executar dois comandos separados: 


set RAILS ENV=production 
bundle exec rake db:migrate 


Testando com o WEB rick 


Após a estrutura inicial ser criada, já podemos iniciar o Redmine 
para verificar o seu funcionamento. 


Para testar se está tudo certo, execute o seguinte comando: 


bundle exec rails server -e production 


Se estiver tudo certo, deverá ser exibida a seguinte mensagem: 


=> Booting WEBrick 

=> Rails 5.2.2 application starting in production on http://0.0.0.0:3000 
=> Run “rails server -hù for more startup options 

=> Ctrl-C to shutdown server 


Então basta acessar http://localhost:3000/ no seu navegador 
preferido para acessar a nova instalação do Redmine. 


Se algo der errado, verifique se o servidor de banco de dados está 
ativo e se não ocorreu nenhum bloqueio de firewall. 


Utilizando o Thin 


Você pode utilizar o WEBrick em ambiente de produção, porém, o 
seu desempenho deixa a desejar quando há mais de um usuário 
utilizando o sistema, pois o servidor não consegue atender a 
requisições de vários usuários ao mesmo tempo. A alternativa mais 
interessante é o Thin, que apresenta um desempenho muito melhor. 


Para utilizar o Thin, precisamos adicioná-lo ao arquivo Gemfile que 
controla as dependências do Redmine. Para isso, basta executar o 
seguinte comando: 


echo gem “thin” >> Gemfile 


E então, executar o comando para instalação do Thin: 


gem install thin 


Após adicioná-lo ao Gemfile e instalá-lo, basta executar o comando 
para iniciar o servidor novamente, que então o Thin será iniciado no 
lugar do WEBrick. 


bundle exec rails server -e production 


=> Booting Thin 

=> Rails 5.2.1 application starting in production on http://0.0.0.0:3000 
=> Run “rails server -hò for more startup options 

=> Ctrl-C to shutdown server 

Thin web server (v1.7.2 codename Bachmanity) 

Maximum connections set to 1024 

Listening on 0.0.0.0:3000, CTRL+C to stop 


Usuário e senha 


Como padrão, os dados de acesso iniciais do Redmine são os 
seguintes: 


Usuário: admin 


Senha: admin 


Meio óbvio e não muito seguro, mas não se preocupe, o Redmine 
vai solicitar que você altere a senha após o primeiro acesso. 


Conclusão 


A instalação automática pode ser mais simples e rápida, porém, em 
ambientes de produção, é importante conhecer todos os 
componentes do Redmine, sabendo como funcionam e como 
podem ser configurados. Conhecê-los será essencial para 
procedimentos de backups, atualizações e demais gerenciamentos 
do seu servidor Redmine. 


CAPÍTULO 5 
Configurações iniciais 


Assim que o Redmine é instalado, as configurações predefinidas 
buscam atender a grande maioria dos cenários. Mas é importante 
que você, como administrador ou administradora do Redmine, 
realize alguns ajustes para que ele facilite o trabalho da sua equipe. 


Boa parte destes ajustes pode ser feita através do menu 
Administração > Configurações, onde há uma série de abas com 
diversas configurações. 


5.1 Geral 





Título da aplicação |Mina Vermelha Sistemas 








Texto de boas-vindas = 
Editar || Pré-visualiz B /7Z7|U|-S |C |Hi ||? | © || := ||== | 25 





Fornecendo sistemas de qualidade graças a você! 

















Número de itens exibidos por página |25 50,100 


Múltiplos va 


ores sao permitidos (separa 





Resultados de pesquisa por página |10 


Dias visualizados na atividade do projeto |30 dias 











Nome do Servidor e subdomínio localhost 3000 








Exemplo: localh: 





Protocolo | HTTP ~v 











Formatação do texto | Textile v 











Realizar cache de texto formatado 














Compactação de histórico do Wiki | nenhum v 


Número de registros por Feed |15 














Salvar 











Figura 5.1: Aba Geral. 
Na aba Geral, é interessante alterar as seguintes configurações: 
Título de aplicação 


Como padrão, o título da aplicação é Redmine, e ele é exibido logo 
abaixo do menu principal. E interessante preencher com o nome da 
sua empresa. 


Texto de boas-vindas 


Este é o texto exibido na página inicial do Redmine. Pode-se utilizar 
esta área para a adição de links utilizados com frequência pelos 
usuários. 


Nome do servidor e subdomínio 


Como padrão, este campo virá preenchido com localhost . É 
importante alterar para o endereço IP do seu servidor, ou então para 


um endereço DNS caso seja acessado externamente. Caso 
contrário, outros usuários podem ter problemas ao acessá-lo. 


Protocolo 


Como padrão, estará habilitado o protocolo HTTP. Caso julgue 
interessante por questões de segurança, é possível configurar para 
que o servidor utilize como padrão o protocolo HTTPS. 


5.2 Autenticação 





Exigir autenticação | Não, permitir acesso anônimo a projetos públicos ~ | 





Quando a autenticação não é obrigatória, projetos 
públicos e seus conteúdos estão disponíveis abertamente 


na rede. Você pode editar as permissões aplicáveis. 


Auto-login | desabilitado v 


Permitido Auto-registro [ativação manual de conta v 








Mostrar campos personalizados no registro 


Comprimento mínimo para senhas 
Requer troca de senha depois | desabilitado v 


Perdi minha senha 


Permitir Login e Registro via OpenID [|] 


Expiração da sessão 


Duração máxima da sessão | desabilitado v 
Tempo limite de inatividade da sessão | desabilitado v 


Aviso: a alteração dessas configurações pode expirar as sessões atuais, incluindo a sua. 


Figura 5.2: Aba Autenticação. 


Através da aba Autenticação é possível configurar como será o 
processo de autenticação ao sistema. E importante prestar atenção 
a estas configurações, para manter o Redmine seguro. 


Exigir autenticação 


Como padrão, esta configuração permite o acesso anônimo a 
projetos públicos. Com isso, qualquer um que acesse o sistema 
pode visualizar as informações da página inicial, além dos projetos 
públicos. Por isso é importante alterar para Sim. 


Permitir autorregistro 


É interessante deixar esta opção desabilitada, ou com a ativação 
manual da conta, caso contrário, qualquer um pode realizar o 
cadastro e acessar o Redmine como um usuário válido. 


5.3 Arquivos 





Tamanho máximo do anexo |5120 KB 











Permitir extensões |pdf, png, jpg, txt 





valores são permitidos (separados po gula). Exemplo: txt, png 





Negar extensões exe, msi, bat, sh, lnk, rb, html, htm, js 











Tamanho máximo dos arquivos textos |512 KB 
exibidos em linha 








Número máximo de linhas exibidas no diff |1500 














Codificação dos repositórios e anexos 











Salvar 








Figura 5.3: Configurações de arquivos. 


Já na aba Arquivos é possível configurar o comportamento do 
sistema ao adicionar arquivos. 


Tamanho máximo do anexo 


Esta configuração permite limitar o tamanho máximo dos anexos. É 
importante configurar um tamanho de arquivo que atenda a maioria 
dos usuários, e que não consuma muitos recursos do sistema. 
Como padrão, este valor é limitado a 5120 KB. 


Permitir extensões 


Esta configuração permite determinar quais as extensões permitidas 
ao adicionar um anexo. 


Negar extensões 


Já esta configuração determina quais os tipos de arquivos que não 
são permitidos. E importante bloquear arquivos que possam causar 
problemas aos usuários ou ao sistema. 


5.4 Configurações avançadas 


Existem algumas configurações do Redmine que não podem ser 
alteradas através do sistema, como configurações de conexão com 
o banco de dados, envio de e-mails, entre outras. 


Para realizá-las, é necessário alterar alguns arquivos do Redmine. 
Os principais arquivos de configurações podem ser encontrados no 
diretório htdocs/config no diretório principal do Redmine. 


No capítulo anterior já alteramos o arquivo database.yml para 
configurar o acesso à base de dados para realizar a instalação 
manual. A partir de agora, vamos explorar os outros arquivos de 
configuração. 


É importante observar que os arquivos YML seguem o padrão 
YAML, que é baseada na indentação com espaços e não é 
permitida a utilização do TAB. Após modificar esses arquivos é 
necessário reiniciar o Redmine para que as alterações sejam 
executadas. 


Configuration.ym!l 


Neste arquivo, as configurações mais importantes são as de envio 
de notificações por e-mail e as de repositórios de controle de 
versões. 


Enviando notificações por e-mail 


Caso você tenha configurado uma conta de e-mail ao instalar o 
Redmine, ele será capaz de enviar notificações para os usuários 
envolvidos nas tarefas, caso sofram atualizações. Por isso, é 
importante, logo após uma instalação ou atualização, fazer um teste 
de envio de e-mail. Para isso, basta acessar a aba Notificações 
por e-mail no menu Administração > Configurações. 


E-mail enviado de redmine(GQminavermelha f00 


Enviar com cópia oculta (cco) 
Usar mensagem sem formatação HTML [|] 


Ações a serem notificadas por e-mail 


Tarefa adicionada 
Tarefa atualizada 
Nota adicionada 
Situação atualizada 
Atribuição atualizada 
Prioridade atualizada 
C] Notícia adicionada 
C] Notícia recebeu um comentário 
[C] Documento adicionado 
[ ]Arquivo adicionado 
[ ] Mensagem enviada 
[ ] Página wiki adicionada 
[ ] Página wiki atualizada 


Marcar todos | Desmarcar todos 


Cabeçalho do e-mail 


Rodapé do e-mail 


Você está recebendo esta notificação porque está observando esta tarefa, 
ou está envolvido com ela. 


Para alterar suas preferências de notificações, acesse o seguinte link: 
http://SEU-REDMINE/my/account 


Enviar um e-mail de teste 





Figura 5.4: Notificações por e-mail. 


Nesta tela é possível ajustar algumas configurações básicas das 
notificações por e-mail, como o endereço de exibição que será 
utilizado ao enviá-los, e o cabeçalho e rodapé das mensagens 
enviadas. 


É importante ajustar a mensagem de rodapé do e-mail de acordo 
com as necessidades da sua empresa, além do endereço de acesso 
para selecionar as preferências de notificações. 


Enviando um e-mail de teste 


Como pode ser visto na imagem anterior, na parte inferior direita há 
um link com a seguinte descrição: Enviar um e-mail de teste. 


Ao clicar neste link, o Redmine utilizará as configurações do servidor 
para enviar um e-mail de testes para o seu usuário. Utilize este link 
sempre que precisar realizar testes de envio de e-mail. Se for 
enviado com sucesso, é possível que os outros usuários do 
Redmine também recebam as notificações sem problemas. 


Para alterar as configurações do servidor utilizado para envio de e- 
mails, basta ajustar o arquivo configuration.yml . Nele, há um bloco 
email delivery Onde devem ser informados os dados de 
autenticação para envio de e-mails. 


É possível realizar o envio através de SMTP ou através do 
Sendmail (utilizando o comando /usr/sbin/sendmail em sistemas 
Unix). 


No exemplo a seguir, temos uma configuração para que o envio de 
e-mails utilize a estrutura do Gmail ou G Suite: 


production: 
email delivery: 

delivery method: :smtp 

smtp settings: 
enable starttls auto: true 
address: "smtp.gmail.com" 
port: 587 
domain: “smtp.gmail.com" 
authentication: :plain 
user name: "seu-email(gmail.com" 
password: “senha” 


Caso seja utilizada a estrutura do Office 365 ou Exchange, basta 
trocar o campo address, domain e authentication desta maneira: 


production: 
email delivery: 

delivery method: :smtp 

smtp settings: 
enable starttls auto: true 
address: "“smtp.office365.com" 
port: 587 
domain: “seu-dominio" 
authentication: :login 
user name: "seu-email(seu-dominio" 
password: “senha” 


Ajuste estas configurações de acordo com os dados de autenticação 
de e-mails da sua empresa. Após reiniciar, é interessante acessar 
as configurações e enviar um e-mail de testes. 


Melhorando a performance ao enviar e-mails 


Imagine a seguinte situação. Você vai acrescentar uma informação 
em uma tarefa que possui 10 observadores. Após o Redmine gravar 
as informações no banco de dados, ele vai enviar e-mail para estas 
10 pessoas e ficará aguardando o retorno dos servidores de destino. 
Felizmente, existe uma forma de fazer com que o Redmine faça 
estas tarefas de forma assíncrona, sem deixar o usuário 
aguardando. 


Caso você possua a versão 4 ou superior do Redmine, não é 
necessário fazer nenhuma alteração nas configurações, pois ele já 
realizará o envio de forma assíncrona. Caso contrário, você 
precisará trocar o método smtp por async smtp, OU O método 


sendmail [pOW async sendmail. 


É importante observar que, com isso, teremos os blocos 
async smtp settings €O não mais smtp settings. O mesmo vale para O 
bloco sendmail settings , que é substituído pelo 


async sendmail settings. 


Essa alteração é muito importante em casos em que o servidor de 
envio de e-mails não está na mesma rede do Redmine. Caso não 
seja utilizado o envio assíncrono, haverá uma demora muito grande 
ao realizar alterações em tarefas. 


Integrando sistemas de controle de versões 


No mesmo arquivo configuration.yml , existem configurações de 

serviços de controle de versão (SCM), que são muito úteis caso 
você queira integrar o Redmine a sistemas como o SVN, GIT ou 
outros. 


Digamos que eu queira integrar o Redmine com o GlT, para isso, 
basta configurar a propriedade scm git command com o caminho do 
executável correspondente ao GIT, como nos exemplos a seguir: 


GIT no Windows: 

scm git command: C:\Program FilesiGitibinigit.exe 
GIT no Linux: 

scm git command: /usr/local/bin/git 


Após reiniciar o Redmine, será possível configurar a integração 
através do menu Administração > Configurações > Repositório. 


SCM habilitados 


Comando Versão 
[|] Subversion O svn 
V] Darcs O darcs 
[M] Mercurial O hg 
V] Cvs O cvs 
[7] Bazaar O bzr 
M Git 2 git 2.9.0 
[C] Filesystem 








ii 
T 


Figura 5.5: O Redmine deverá exibir quais os SCM habilitados. 


Ao habilitar algum SCM, será possível adicionar repositórios aos 
projetos, para que o Redmine altere a situação e o percentual de 
conclusão de uma tarefa através da análise de mensagens de 
commits. 


Basta definir palavras-chaves e escolher a situação e o percentual 
como na imagem a seguir. 


Referenciando tarefas nas mensagens de commit 





Palavras-chave de referência |refs references IssuelD 











Múltiplos valores são permitidos (separados por vírgula 





Permitir que tarefas de todos os outros 
projetos sejam refenciadas e resolvidas 














Habilitar registro de horas |v 











Atividade para registrar horas | Desenvolvimento 























Tipo de tarefa Definição de palavras-chave Situação alterada % Terminado 
todos v| |fechar,pronta Pronta v 100 % » 
todos v| [testes Pronta para testes v 60% » m 



































Múltiplos valores são permitidos (separados @ 
Jor virgula 


Figura 5.6: É interessante habilitar o registro de horas também. 


Digamos que eu queira enviar a tarefa #123 para testes ao realizar o 
commit de qualquer arquivo e informar ao sistema que foram 
empenhadas 3 horas e 35 minutos em seu desenvolvimento. Basta 
preencher a mensagem de commit com o número da tarefa com + 
na frente, utilizar a palavra-chave testes, e @ com a quantidade de 
horas empenhadas, como no exemplo a seguir: 


Realizado ajuste na rotina X [demais detalhes]. Enviando para testes a 
tarefa #123. (03:35 


O Redmine vai capturar esta mensagem, e fará os ajustes na tarefa, 
além de relacionar o commit à tarefa. 


Adicionando repositórios aos projetos 


Para adicionar repositórios aos projetos basta acessar a aba 
Repositórios nas configurações dos projetos, e então informar os 
dados de acesso. 


No caso do SVN, basta informar a URL do repositório e os dados de 
autenticação, que o Redmine fará o acesso ao servidor de controle 
de versão. 


Novo repositório 





Controle de versão: | Subversion v 











Repositório principal |v 














Identificador |redmine 








deve ter entre 1 e 255 caracteres. Somente letras minúsculas (az), números 

















ços e sublinhados são permitidos. Uma vez salvo, o identificador não pode ser alterado 
URL * |https://svn.redmine.orgiredmine/ 
Examplos: file http https://, svn://, svn+[tunnelscheme]:/ 
Usuário 
Senha 











Criar | Cancelar 


Figura 5.7: Exemplo de configuração de repositório utilizando o Subversion. 


Já para outros tipos de repositórios, como o GIT, por exemplo, é 
necessário ter um clone do repositório no mesmo servidor do 
Redmine. E então cadastrar o caminho local do repositório. 


Novo repositório 





Controle de versão: | Git y 











Repositório principal [v 























Identificador |repositorio 


traços e sublinhados sã 





Caminho para o |C'iFontesiminavermelhaapp!.git 
repositório * penositório esta vazio JE 











Codificação do caminho v 











Relatar última alteração 
para arquivos e diretórios 

















Criar | Cancelar 








Figura 5.8: Exemplo de configuração de repositório utilizando o GIT. 


DICA: MANTENDO O REPOSITÓRIO ATUALIZADO! 


Para agilizar o processamento de repositórios GIT, é 


interessante executar o seguinte comando antes de adicioná-lo 
ao Redmine, para atualizar a cópia local dos arquivos: git fetch 
-q --all -p. 





Também é importante adicionar um agendamento no sistema 
operacional executando o mesmo comando, para que as 
informações sejam atualizadas periodicamente. Caso contrário, a 
integração pode não funcionar corretamente. 


Conclusão 


Todas estas configurações serão essenciais para o gerenciamento 
do Redmine e servirão de base para realizar instalações, 
atualizações, backups entre outras operações que veremos nos 
próximos capítulos. 


CAPÍTULO 6 
O que é um projeto e como gerenciá-los no 
Redmine 


Por ser um sistema de gerenciamento de projetos, o foco primário 
do Redmine são de fato os projetos. Mais de 80% dos dados no 
Redmine são relacionados a projetos. Desta forma, ao otimizar a 
forma como você trabalha com eles, é possível atingir uma maior 
eficiência e produtividade no seu dia a dia de trabalho. 


Mas primeiro, é importante revermos os conceitos do termo Projeto! 
Segundo a sexta edição do livro PMBOKO (Project Management 
Body of Knowledge ou Guia do Conhecimento em Gerenciamento 
de Projetos, escrito pelo instituto PMI - Project Management 
Institute), "projeto é um esforço temporário empreendido para criar 
um produto, serviço ou resultado único”. 


Mas talvez mais importante do que esta definição é o que você e/ou 
a sua empresa adotam para a palavra "projeto". Isso depende muito 
do cenário em que você se encontra, pois um projeto pode abranger 
vários tipos de produtos, serviços ou resultados. 


Tenha em mente que um projeto pode envolver várias áreas, nem 
sempre relacionadas a softwares, como é o caso da Mina Vermelha 
Sistemas. Podemos, por exemplo, ter projetos envolvendo 
construção civil, consultorias ambientais, serviços de fotografia ou 
até mesmo o processo de escrita de um livro como este que você 
está lendo. 


No caso da Mina Vermelha Sistemas, o Redmine vem de encontro à 
necessidade de oferecer um suporte mais ágil facilitando a 
comunicação entre as equipes de suporte, desenvolvimento e 
infraestrutura. Dependendo da solicitação do cliente, ela pode se 
transformar em um projeto contendo várias tarefas, ou pode ser 


resolvida diretamente. Veremos mais sobre estas estratégias no 
capítulo Gerenciando Projetos. 


Principais vantagens ao gerenciar projetos com o Redmine 


Como podemos ter diferentes tipos de projetos, o Redmine permite 
o relacionamento de diversos itens, possibilitando a utilização por 
empresas não relacionas à tecnologia da informação. 


E além disso, ele possui algumas características que trazem 
facilidade no processo de gerenciamento como: 


e Gerenciamento de vários projetos em uma única instalação. 
e Diferentes permissões para os usuários em cada projeto. 

e Módulos e campos definidos por projeto. 

e Subprojetos compartilhando itens de outros projetos. 

e Gerenciamento de versões do projeto. 


Nos próximos capítulos veremos estas e outras características. 
Tenha em mente que o Redmine está à sua disposição para auxiliá- 
lo e, sabendo utilizá-lo corretamente, você conseguirá gerenciar os 
mais diversos tipos de projetos. 


A importância do trabalho em equipe 


Não é impossível a utilização do Redmine por uma única pessoa, 
mas esta prática deve ser adotada apenas quando esta pessoa 
trata-se da única envolvida no projeto. Nos demais casos, é 
importante que todos os envolvidos utilizem o Redmine com 
frequência, atualizando as informações sobre os projetos em que 
estejam trabalhando. 


Por este fato, repasse as dicas a seguir para seus colegas de 
equipe, para que estes utilizem o Redmine da mesma forma que 
você. Isso fará com que sua equipe tenha um aumento de 
produtividade por gerenciar os projetos com mais eficiência. 


CAPÍTULO 7 
Criando seu primeiro projeto 


Como vimos no capítulo anterior, boa parte dos dados do Redmine 
são relacionados a projetos. A partir de agora vamos abordar o 
processo de criação de projetos através do Redmine. 


Utilizando a sua instalação do Redmine, você verá no menu superior 
esquerdo um link chamado Projetos. Através deste link você poderá 
visualizar os projetos existentes na sua instalação do Redmine, 
onde também será possível adicionar novos projetos. 


Página inicial Minha página Projetos Administração Ajuda 


Redmine 





Pro j etos © Novo projeto 


Figura 7.1: Nesta tela serão exibidos os projetos aos quais o usuário tiver permissão. 


Adicione o seu primeiro projeto clicando em Novo Projeto, e então 
descreva detalhadamente qual o objetivo dele. 


Novo projeto 


Identificador * Imina-vermelha-app 


Página do projeto 





Nome * [Mina Vermelha App 








Descrição em | pe: 
£ Editar BIrZIVISIÇ Hi H2 H3 >= E i pre o Bi] 


Projeto para criação de um aplicativo mobile , capaz de fornecer aos clientes da Mina 
Vermelha Ltda. o acesso aos seus dados através de dispositivos móveis. 


























Público 





7K 





Subprojeto de v 


Herdar membros [|] 











Figura 7.2: Esta tela servirá para você cadastrar o seu primeiro projeto no Redmine. 


No momento do cadastro, existem os seguintes campos para 
preenchimento: 


Nome: nome de exibição do projeto. 

Descrição: descrição do projeto. 

Identificador: usado internamente pela aplicação. Não poderá 
ser alterado após a criação do projeto! 

Página do projeto: link relacionado ao projeto. 

Público: caso esteja marcado, qualquer um pode visualizar o 
projeto, caso contrário, apenas membros, de acordo com suas 
permissões. 

Subprojeto de: permite definir um projeto pai (somente é 
exibido caso já existam outros projetos cadastrados). 

Herdar membros: caso seja filho de outro projeto, terá os 
mesmos membros do projeto pai. 


Destes campos, apenas dois são obrigatórios, o nome e o 
identificador do projeto, mas busque detalhar claramente no campo 
de descrição qual será o objetivo principal dele para que os outros 
usuários compreendam. 


Como no exemplo da imagem anterior, ao criar o projeto está sendo 
descrito o objetivo principal do projeto Mina Vermelha App de forma 
simples para que mesmo pessoas não envolvidas com o projeto 
compreendam seu objetivo. 


Além disso é possível definir quais serão os módulos disponíveis no 
projeto. 


& Módulos 


Gerenciamento de Tarefas Gerenciamento de tempo 


Noticias Documentos 
Arquivos Wiki 
Repositório Fóruns 
Calendário Gantt 


Figura 7.3: Nos próximos capítulos veremos detalhadamente as funções de cada um dos 
módulos disponíveis. Deixe todos marcados por enquanto. 


Os projetos no Redmine possuem vários módulos que podem ser 
habilitados como: 


e Gerenciamento de tarefas: atividades a serem desenvolvidas 
no projeto. 

e Gerenciamento de tempo: relatórios de tempo empenhado no 
projeto. 

e Notícias: notícias/releases disponíveis no projeto. 

e Documentos: documentações do projeto, permitindo textos 
puros. 

e Arquivos: controle de arquivos (permitindo separar por versão). 

e Fóruns: fóruns de discussão relacionados ao projeto. 

e Wiki: páginas com informações sobre o projeto 
(documentações). 

e Repositórios: permitindo o relacionamento de projetos com 
repositórios de controle de versão. 


Dependendo do tipo do projeto, cada item pode ter mais ou menos 
importância para o gerenciamento do projeto. Nos capítulos a seguir 
serão detalhados alguns destes módulos. 


Mina Vermelha App 





Visão geral [vo Fo TT UT 


Visão geral O Novo subprojeto (5) Fechar 


Projeto para criação de um aplicativo mobile, capaz de fornecer aos 
clientes da Mina Vermelha Ltda. o acesso aos seus dados através de 
dispositivos móveis. 


=] Tarefas 

Abertas Fechadas Total 
Bug 0 0 0 
Funcionalidade 0 0 0 
Suporte 0 0 0 


Ver todas as tarefas | Calendário | Gantt 


Figura 7.4: Após a criação do projeto, ele ficará disponível no menu Projetos, onde você 
poderá visualizar seus detalhes. 


Desta forma criamos o primeiro projeto da Mina Vermelha Sistemas, 
onde as equipes poderão se organizar para tornar o projeto Mina 
Vermelha App um aplicativo de sucesso para seus usuários atuais e 
atrair novos clientes para o seu negócio. 


Faça a mesma coisa que o pessoal da Mina Vermelha e cadastre o 
projeto que você espera que seja um sucesso! 


Lembre-se de que é possível adicionar vários projetos ao Redmine, 
e posteriormente, veremos como relacioná-los entre si. 


Conclusão 


Agora que você já sabe como cadastrar os seus projetos, será 
possível gerenciá-los, adicionando vários itens. Veremos qual a 
utilidade de cada um destes itens no próximo capítulo. 


Antes de prosseguir, vamos testar algumas das habilidades 
envolvendo o Redmine que você adquiriu até então. Utilize o QR 
Code a seguir com o seu celular, ou então acesse o seguinte 
endereço: http://bit.ly/redlab1/ 





Figura 7.5: http://bit.ly/redlab1. 


Siga as instruções existentes no link e então prossiga com a leitura. 


CAPÍTULO 8 
Tarefas 


Assim como os projetos são responsáveis por manter tudo junto e 
organizado, as tarefas são responsáveis por registrar o trabalho do 
dia a dia, por isso também são um dos itens principais do Redmine. 


Pode existir um projeto sem tarefas”? Dificilmente. 


O projeto busca alcançar um determinado objetivo, e dentro dele é 
comum termos uma série de ações a serem desenvolvidas para 
alcançá-lo. E para isso é que existem as tarefas no Redmine. 


Imagine que você tenha um projeto para realizar em casa, que 
consiste em fazer um churrasco no próximo domingo. Quais as 
tarefas que seriam necessárias para a realização deste projeto”? 


Possivelmente você pensou em várias atividades possíveis, como: 


e Fazer uma lista de compras 
e Ir ao mercado 

e Temperar a carne 

e Acender o fogo 

e Assar a carne 

e Comer 


Cada um pode definir tarefas diferentes, e são elas que definirão a 
organização do projeto, independente de qual for o objetivo. 


8.1 Adicionando a sua primeira tarefa 


Após adicionar o seu primeiro projeto, você terá acesso a um menu 
para efetuar ações apenas no projeto selecionado. Neste menu, 
você terá uma opção chamada Nova Tarefa. Como o próprio nome 


já diz, este item servirá para que os usuários adicionem novas 
tarefas ao projeto. 


No caso do nosso projeto Mina Vermelha App, nossa primeira tarefa 
pode ser o levantamento de requisitos, que servirá de base para a 
criação de novas tarefas após a análise. 





+ Visão geral Atividade Tarefas Tempo gasto Gantt Calendário Notícias Documentos Wiki 


Nova tarefa 








Tipo * | Suporte v Privado 























Título * [Realizar o Levantamento dos Requisitos 
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Realizar o levantamento de requisitos para o desenvolvimento do aplicativo 
Mina Vermelha App, realizando entrevistas com clientes chaves para definir o escopo 
funcional do projeto. 



























































Situação * | Nova v Tarefa pai A 
Prioridade * [Normal ” Início [91/04/2025 
Atribuído para ” Data prevista |39/04/2025 
Tempo estimado |24 Horas 
9% Terminado |0 % v 














Arquivos | Escolher arquivos | Nenhum arquivo selecionado (Tamanho máximo: 5 MB) 


Observadores O Procurar por outros observadores para adicionar 





Figura 8.1: Apenas 4 campos são necessários para a criação de uma nova tarefa. 


Para adicionar uma tarefa, existem os seguintes campos para 
preenchimento: 


e Tipo: tipo da tarefa, para permitir tratamentos diferenciados. 

e Título: descrição principal dos objetivos da tarefa. 

e Descrição: descrição detalhada da tarefa (permite sintaxe wiki). 
e Situação: situação em que a tarefa se encontra. 

e Prioridade: nível de importância da tarefa. 

e Atribuído para: quem será o responsável pela tarefa. 

e Tarefa pai: caso a tarefa seja uma subtarefa de outra. 

e Início: data de início da tarefa. 


e Data prevista: data prevista para conclusão da tarefa. 

e Tempo estimado: tempo estimado em horas para 
desenvolvimento. Este campo pode ser informado com 
decimais. 

e % Terminado: percentual de conclusão de 0% a 100%. 

e Privado: determina que a tarefa será privada e apenas terão 
acesso a ela os envolvidos ou administradores. 


Os campos tipo, título, situação e prioridade são obrigatórios para 
a criação da tarefa, pois influenciarão no comportamento das tarefas 
como veremos no capítulo Personalizando o Redmine. 


Após adicionar sua tarefa, será possível visualizar detalhes dela, 
assim como editá-la, adicionando mais informações. 





E E] RR DT Tarefas [Sua e) Ter To RR DE TT TA 


æ Tarefa #1 criada. 


Suporte #1 4 Editar Q Tempo de trabalho Observar Copiar fi Excluir 


Realizar o Levantamento dos Requisitos 


Adicionado por Gerente dos Projetos menos de um minuto atrás. 


Situação: Novo Início: 01/04/2025 
Prioridade: Normal Data prevista: 30/04/2025 
Atribuído para: - 9% Terminado: 
0% 
Tempo estimado: 21.00 h 
Descrição 


O Responder 


Realizar o levantamento de requisitos para o desenvolvimento do aplicativo Mina Vermelha App, 
realizando entrevistas com clientes chaves para definir o escopo funcional do projeto. 


Subtarefas Adicionar 


Tarefas relacionadas Adicionar 


Figura 8.2: Como foi a primeira tarefa criada, esta recebeu o ID #1, podendo ser 
referenciada em outras áreas do Redmine. 


Já ouviu aquele ditado de que uma imagem é mais importante do 
que mil palavras? Ao adicionar uma tarefa, você pode utilizar 
imagens para explicar melhor a ideia que você deseja transmitir. 
Isso é importante, pois há pessoas que compreendem melhor ou 
mais rapidamente por meio de imagens. 


Para adicionar uma imagem, você deve adicionar um arquivo de 
imagem na tarefa como se fosse um anexo e então informar o nome 
do arquivo entre pontos de exclamação como no exemplo a seguir: 


limagem.png! 


O Redmine tentará exibir qualquer tipo de arquivo. A única limitação 
ficará por conta do navegador do usuário. Por isso, utilize de 
preferência imagens nos formatos JPG, GIF e PNG, devido à 
grande compatibilidade com os navegadores atuais. 


Criando ligações para tarefas 


O Redmine possui uma série de padrões que podem ser utilizados 
em campos de texto com o objetivo de relacionar itens, garantindo 
uma ligação entre as informações, dando-lhes mais sentido. 


Por exemplo, se eu estiver criando uma tarefa e precisar comentar 
que algo foi visto já na tarefa de número 1, basta adicionar o 
símbolo de Hashtag ( + ) na frente do número para que seja criado 
um vínculo com a tarefa de número 1. Exemplo: 


Esta tarefa serve para corrigir um problema causado pela implementação da 
tarefa #1. 


Automaticamente será gerado um link para a tarefa 41. 


Bug #2 4 Editar Q} Tempo de trabalho Observar Copiar fi] Excluir 


Correção de problema no cálculo de horas 


Adicionado por Gerente dos Projetos 1 minuto atrás. 


Situação: Novo Início: 01/04/2025 
Prioridade: Normal Data prevista: 30/04/2025 
Atribuído para: - 9% Terminado: 
0% 
Tempo estimado: 8.00 h 
Descrição 


Q Responder 
DETALHES SOBRE A ATIVIDADE 


Esta tarefa serve para corrigir um problema causado pela implementação da tarefa #1. 


Subtarefas Adicionar 


Tarefas relacionadas Adicionar 


Figura 8.3: Desta maneira é possível relacionar as atividades de forma ágil. 


8.2 Subtarefas 


Como vimos no processo de criação de uma tarefa, é possível 
definir uma tarefa pai ao criar uma tarefa. Da mesma forma, 
também é possível adicionar subtarefas a uma tarefa já criada, 
como pode ser visto na imagem anterior. 


Digamos que queremos organizar a tarefa #1 Realizar o Levantamento 
dos Requisitos em subtarefas para um melhor controle das etapas. 
Poderíamos adicionar duas subtarefas para a entrevista com dois 
clientes atuais. Desta forma, ao concluir uma delas, 


automaticamente a tarefa pai passaria para o percentual de 
conclusão de 50%, além de realizar um somatório do tempo gasto. 


Suporte #1 4 Editar Q} Tempo de trabalho Observar Copiar fij Excluir 


Realizar o Levantamento dos Requisitos « Anterior 


Adicionado por Gerente dos Projetos 22 minutos atrás. 


Situação: Novo Início: 01/04/2025 
Prioridade: Normal Data prevista: 30/04/2025 
Atribuído para: - 9 Terminado: 
50% 
Tempo estimado: 21.00 h 
Tempo gasto: (Total: 2.00 h) 
Descrição 


OQ Responder 


Realizar o levantamento de requisitos para o desenvolvimento do aplicativo Mina Vermelha 
App, realizando entrevistas com clientes chaves para definir o escopo funcional do projeto. 


Subtarefas 


Adicionar 
suporte-+2: Entrevistar o Cliente Fulano Fechado 
Suporte #3: Entrevistar o Cliente Sicrano Novo 
Tarefas relacionadas idade 


Figura 8.4: As subtarefas alteram a tarefa pai automaticamente. 


Esta é uma funcionalidade muito interessante do Redmine, que 
permite a criação de hierarquias entre tarefas, porém, é importante 
compreender o funcionamento padrão destas tarefas antes de 
utilizá-las. 


Ao adicionar tarefas filhas a uma tarefa, transformando-a em tarefa 
pai, alguns dos campos desta tarefa ficarão bloqueados, pois 
dependerão dos campos das subtarefas de acordo com a seguinte 
lógica de funcionamento: 


e Data de início: a data da tarefa pai será a menor data de início 
das subtarefas. 

e Data prevista: a data da tarefa pai será a maior data prevista 
das subtarefas. 

e Prioridade: a prioridade da tarefa pai será a prioridade mais 
alta das subtarefas. 

e Percentual: o percentual da tarefa pai será a média do 
percentual das subtarefas. 

e Tempo estimado: o tempo estimado da tarefa pai será a soma 
do tempo estimado das subtarefas. 


Compreendendo esta lógica, as subtarefas podem se mostrar 
vantajosas em projetos com muitas tarefas relacionadas entre si. 


Alterando o comportamento das subtarefas 


A partir da versão 3.2.3, é possível alterar o comportamento das 
subtarefas através das configurações acessando Administração > 
Configurações > Tarefas, como pode ser visualizado na imagem a 
seguir. 


Tarefas 


Atributos das tarefas pai 





Início / Data prevista | Calculado das subtarefas v 














Prioridade | Calculado das subtarefas v 


% Terminado | Calculado das subtarefas v 


Calculado das subtarefas 
| Independente das subtarefas | 








Figura 8.5: Desta forma é possível personalizar o Redmine de acordo com suas 
necessidades. 


8.3 Tempo de trabalho 


Ao criar uma tarefa, será possível controlar o tempo utilizado para a 
realização dela. 


Digamos que foram empenhadas 2 horas para visita ao cliente. Para 
adicionar esta informação e realizar o lançamento de tempo nas 
tarefas, existem 2 maneiras principais: 


Ao editar a tarefa 


Ao editar uma tarefa, você terá a opção de informar o tempo gasto, 
o tipo da atividade e um comentário. 


Editar 


Alterar propriedades 





Projeto * | Mina Vermelha App Y [C] Privado 











Tipo * | Suporte v| 














Título * |Entrevistar o Cliente Fulano 





Descrição / Editar 



































Situação * | Fechado v Tarefa pai 41 
Prioridade * | Normal y Início ge 
Atribuído para v a 
Data prevista 30/04/2025 








Tempo estimado Horas 
9% Terminado | 100 % v 





Tempo de trabalho 
Tempo gasto |2 Horas Atividade | Planeamento ~] 














Comentário Realizada visita ao cliente e realizada uma série de questionamentos | 





Figura 8.6: O tempo gasto na atividade ficará relacionado à edição da atividade. 
Realizando o lançamento individualmente 


Outra maneira de informar o tempo gasto na atividade é informar 
individualmente através do link Tempo de Trabalho existente ao 


lado do título da tarefa. 
Tempo gasto 


Tarefa |9 2 Suporte #2: Entrevistar o Cliente Fulano 





Data * | 07/04/2025 











Horas * |2 














Comentário Realizada visita ao cliente onde foi realizada uma série de questionamentos 











Atividade * | Planeamento v 

















| Criar | Criar e continuar 





Figura 8.7: Desta forma é possível informar a data em que a atividade foi realizada. 


Existe ainda uma terceira forma de registrar o tempo gasto, que 
funciona através de comentários de sistemas de controle de versão 
como o GlT e o SVN. Que vimos como configurar no capítulo 
Configurações iniciais. 


Os seguintes formatos são válidos ao registrar o tempo gasto: 


1h, 1h, 1 hour, 2 hours, 30m, 30min, 1h30, 1h30m, 1:30, 1.5, 1,5 


Para visualizar detalhadamente e editar o tempo de trabalho basta 
clicar sobre o número de horas gastas exibido na descrição da 
tarefa. 


Conclusão 


Sabendo como gerenciar os projetos, tarefas e subtarefas no 
Redmine já conseguimos manter os nossos projetos organizados, 
permitindo que as etapas do projeto sejam registradas, focando no 
objetivo principal do projeto. 


Quanto mais informações adicionadas aos projetos, mais claro fica o 
seu escopo. No próximo capítulo veremos outras maneiras de 
adicionar informações aos projetos, mas tenha em mente que os 


projetos e tarefas são essenciais para o bom gerenciamento dos 
dados no Redmine. 


CAPÍTULO 9 
Adicionando mais informações aos seus projetos 


Além de tarefas, existem outros itens que possibilitam a adição de 
informações aos projetos. O objetivo deste capítulo é apresentá-los 
para que você julgue qual pode ser útil para a sua equipe de acordo 
com as necessidades atuais. 


9.1 Notícias: mantenha sua equipe informada 


O módulo de notícias serve como excelente ferramenta para 
lançamento de releases de versões, informando quais as atividades 
que foram desenvolvidas em uma determinada versão. 


Além disso, as notícias servem para repassar informações em geral 
para os membros envolvidos. As notícias adicionadas serão 
exibidas no item Ultimas notícias na página inicial do projeto. 
> Ultimas noticias 
Planejamento - Sprint 1 
Atividades a serem desenvolvidas na Primeira Sprint 


Adicionado por Gerente dos Projetos 1 minuto atras 


Ver todas as noticias 


Figura 9.1: Listagem de notícias na página inicial do projeto. 


Adicionando notícias 


Para adicionar uma notícia, basta acessar a aba Notícias, e clicar 
em Adicionar Notícia. 


Adicionar notícia Q Adicionar notícia fr Observar 








Título * [Planejamento - Sprint 1 








Resumo |atividades a serem desenvolvidas na Primeira Sprint 











Descrição * 


In 
Il 


Editar | Pré-visualiza B| Z || U|- |C |/Hi || H2 || E || := | pre <> oa E 





Segue abaixo a relação de atividades a serem desenvolvidas na primeira Sprint 


#7273 - Definir funcionalidades básicas do sistema 
#7280 - Definir métodos da API 

#7282 - Realizar a modelagem da base de dados da API 
#7287 - Realizar a modelagem da base de dados local 
#7291 - Definição da interface 














Arquivos | Escolher arquivos | Nenhum arquivo selecionado (Tamanho máximo: 5 MB) 








Figura 9.2: O cadastro de notícias é bem simples, basta informar um título e o texto. 


Da mesma forma que nas tarefas, também é possível adicionar 
imagens às notícias para deixá-las mais informativas. Após 
adicionar uma notícia, os usuários poderão adicionar comentários 
expondo suas opiniões a respeito do assunto. 


No nosso exemplo, o gerente do projeto da nossa empresa fictícia 
decidiu cadastrar uma espécie de informativo interno comunicando 
as atividades a serem desenvolvidas durante a primeira sprint do 
projeto Mina Vermelha App. 


Planejamento - Sprint 1 


Atividades a serem desenvolvidas na Primeira Sprint 
Adicionado por Gerente dos Projetos menos de um minuto atrás 


Segue abaixo a relação de atividades a serem desenvolvidas na primeira Sprint: 


#7282 - Realizar a modelagem da base de dados da API q“ “ 
#7287 - Realizar a modelagem da base de dados local 
#7291 - Definição da interface mm 


#7273 - Definir funcionalidades básicas do sistema 
7280 - Definir métodos da API 





© Comentários 


Adicionar comentário 


Figura 9.3: Exemplo de uma notícia com imagem. 
Criando ligações para notícias 


As notícias podem ser relacionadas em outras áreas do Redmine 
como tarefas, comentários entre outras, utilizando o seguinte 
padrão: 


newstCÓDIGO 
Exemplo: 


Isto permite o cadastro de uma tarefa com o seguinte comentário: 


De acordo com observações existentes na notícia newst3, se torna 
necessário o desenvolvimento de um ajuste na rotina de importação de dados 


Esse 


Desta maneira, será criado um link que permitirá que os usuários 
acessem a terceira notícia cadastrada, pois foi informado o código 
3. 


Funcionalidade #4 4 Editar Q Tempo de trabalho Observar Copiar fi Excluir 


Importação de Dados t 1/3 | Próximo » 


Adicionado por Gerente dos Projetos menos de um minuto atrás. 


Situação: Novo Início: 01/04/2025 
Prioridade: Normal Data prevista: 
Atribuído para: - 9 Terminado: 
0% 
Descrição OQ Responder 


De acordo com observações existentes na notícia Definições da Nova Estrutura de Dados, se 
torna necessário o desenvolvimento de um ajuste na rotina de importação de dados realizando 
a leitura de arquivos CSV e adicionando os registros na tabela de usuários. 


Subtarefas Adicionar 


Tarefas relacionadas Adicionar 


Figura 9.4: Exemplo de tarefa relacionando uma notícia. 


9.2 Fóruns: mantenha as discussões organizadas 


Outro módulo útil para grandes equipes dentro do Redmine é o 
módulo de Fóruns, que permite a criação de tópicos para discussão 
por parte dos usuários. 


Após a criação de um tópico, os usuários podem adicionar 
comentários enquanto ele estiver aberto. 


Habilitando fóruns ao seu projeto 


Como padrão, não é exibida uma aba de fóruns como os outros 
módulos. Para exibi-la, é necessário acessar as configurações do 
projeto. 


Abra a aba de Configurações e então acesse a subaba Fóruns. 
Basta clicar em Novo fórum e adicionar um nome e descrição para 
o seu fórum. 





EA CCR: | RR TO EO E O CR SUL TAM Configurações 





« Criado com sucesso. 





Configurações 
Informações | Módulos | Membros || Versões || Categorias das tarefas | Wiki || Repositórios || Fóruns 
Fórum 


Definição do Escopo Fórum criado para discussões a respeito das funcionalidades $ 4 Editar Œ Excluir 
do projeto Mina Vermelha App 


Q Novo fórum 


Figura 9.5: É possível criar vários fóruns no projeto. 


Ao adicionar o primeiro fórum, a aba Fóruns já ficará visível no 
projeto, onde é possível iniciar novos tópicos clicando em Nova 
mensagem, quando será exibida uma tela semelhante à imagem a 
seguir: 


Fóruns » 


Definição do Escopo » Nova mensagem ® Nova mensagem Jr Observar 











Título 

[Funcionalidades iniciais | C] Marcado [ ] Bloqueado 
Editar || Pré-visualizar B Z| U|S|C | m|m|m®||:= |=| |2 Epre || <> 
olá, 


estou criando este tópico para discutirmos as funcionalidades iniciais do 
projeto. 


O que vocês acreditam que seria essencial para o funcionamento do 
aplicativo? 





Arquivos 


Escolher arquivos | Nenhum arquivo selecionado (Tamanho máximo: 5 MB) 





Figura 9.6: Tela de criação da mensagem. 


Ao adicionar, você terá as opções Marcado para deixar a 
mensagem em destaque, e Bloqueado para impedir a adição de 
comentários. 


Caso a mensagem não esteja bloqueada, os usuários poderão 
adicionar comentários e continuar a discussão com base na 
mensagem inicial. 


Fóruns » Definição do Escopo » 

Funcionalidades iniciais Yr Parar de observar Q Responder 4 Editar fã Excluir 
Adicionado por Gerente dos Projetos 3 minutos atrás 

Olá, 

estou criando este tópico para discutirmos as funcionalidades iniciais do projeto. 


O que vocês acreditam que seria essencial para o funcionamento do aplicativo? 


© Respostas (1) 
RE: Funcionalidades iniciais - Adicionado por Analista menos de um minuto atrás D4 


Acredito que uma tela de /ogin é algo essencial para que cada usuário acesse apenas os seus 
próprios dados. 


Como vocês acham que deve funcionar o cadastro destes usuários? 
(1-1/1) 


Responder 


Figura 9.7: Exemplo de discussão no fórum do Redmine. 
Criando ligações para fóruns 


Da mesma forma que nas notícias, os fóruns também possuem um 
padrão para que possam ser relacionados a outras áreas do 
Redmine. 


Para criar uma ligação para um fórum, basta utilizar o seguinte 
padrão: 


forumECÓDIGO 


Também é possível criar ligações para mensagens exclusivas do 
fórum utilizando o seguinte padrão: 


messageHCÓDIGO 
Exemplo: 
De acordo com discussão realizada no fórum forum#1, definimos que a 


importação deverá ocorrer diariamente, seguindo as regras definidas pelo 
nosso Gerente de Projetos (message&3) 


Com isso, serão criados links para o fórum sobre a definição do 
escopo, além de ser criado um link diretamente para a terceira 
mensagem cadastrada. 


| æ Tarefa #5 criada. 
Funcionalidade #5 4 Editar Q Tempo de trabalho Observar Copiar fi Excluir 


Criação de Script para Sincronização Anterior | 1/4 | Próximo » 


Adicionado por Gerente dos Projetos menos de um minuto atrás. 


Situação: Novo Início: 10/04/2025 
Prioridade: Normal Data prevista: 

Atribuído para: - 9% Terminado: 0% 
Descrição 


O Responder 


De acordo com discussão realizada no fórum Definição do Escopo, definimos que a importação deverá 
ocorrer diariamente, seguindo as regras definidas pelo nosso Gerente de Projetos (RE: Funcionalidades 
iniciais). 

Por isso é necessária a criação de um script para ser executado através de agendamento do sistema 
operacional. 


Subtarefas Adicionar 


Tarefas relacionadas Adicionar 


Figura 9.8: Exemplo de tarefa relacionando mensagens de um fórum. 


9.3 Documentos: gerencie a documentação do 
seu projeto 


O Redmine possui também um gerenciador eletrônico de 
documentos (GED ou DMS - Document Management System) 
simplificado, onde é possível adicionar arquivos a uma versão 
determinada. 


Como padrão, o Redmine possui a opção de cadastrar 
Documentação do Usuário e Documentação Técnica. Porém, 
podem ser configurados novos tipos de documentos através do 
menu de administração. 


Adicionando documentos 


Para adicionar documentos o processo é muito simples, basta 
acessar a aba de Documentos, clicar em Novo documento e 
então preencher as informações necessárias, como pode ser visto 
na imagem a seguir. 


Novo documento 





Categoria | Documentação técnica v | 











Título * [Funcionamento da Sincronia de Dados 





Descrição — == — 
Editar || Pré-visualizar BIFIUISIC Hi H2 H3 = |32| |25 


In) 


A sincronia de dados do projeto *Mina Vermelha App* funcionará 
através de uma API REST, que trabalhará com um Token criptografado, 
garantindo assim a segurança das informações. 





Esta API possuirá um versionamento para garantir a compatibilidade 
mesmo com versões desatualizadas do aplicativo, pois podem existir 
usuários com versões antigas. 


hi. Métodos Principais 
h2. Login 


Este método terá a função de realizar a autenticação dos usuários 


* *URL:* /login v 
* *Parametros:* 














Arquivos | Escolher arquivos | Nenhum arquivo selecionado (Tamanho máximo: 5 MB) 





Figura 9.9: Cadastro de documentação técnica. 


Ao adicionar um documento, você pode também adicionar arquivos, 
por isso este módulo pode ser útil para adição de documentações 


relacionadas ao projeto. No nosso exemplo, foi realizado o cadastro 
de uma documentação técnica para auxiliar outros desenvolvedores 
a compreenderem o funcionamento do sistema. 


Funcionamento da Sincronia de Dados 4 Editar fij Excluir 


Documentação técnica 

15/04/2025 

A sincronia de dados do projeto Mina Vermelha App funcionará através de uma API REST, 
que trabalhará com um Token criptografado, garantindo assim a segurança das 
informações. 


Esta API possuirá um versionamento para garantir a compatibilidade mesmo com versões 
desatualizadas do aplicativo, pois podem existir usuários com versões antigas do aplicativo. 


Métodos Principais 
Login 
Este método terá a função de realizar a autenticação dos usuários 


* URL: /login 
* Parametros: 


* usuario: Nome do usuario informado na tela de login 
«e hash: Hash da senha informada na tela de login 
« verificador: Hash de verificação gerado pelo aplicativo 


« Retornos: 
e 200: Login efetuado com sucesso. 


* 403: Acesso negado. 
e 404: Usuário não encontrado. 


Figura 9.10: Documentação técnica detalhando o funcionamento da sincronia de dados. 
Criando ligações para documentos 


Para criar links para documentos o Redmine permite a utilização de 
dois padrões: 


e Através do código: documenttcóDIGO 
e Ou através do título do documento: document: TÍTULO 


Desta forma, podemos criar ligações para os documentos como no 
exemplo a seguir. 


Exemplo: 


A implementação desta tarefa vai de encontro à análise de requisitos 
detalhada no seguinte documento: document&1 


Desta maneira, será criado um link que permitirá que os usuários 
acessem a documentação. 


Historico 
Atualizado por Gerente dos Projetos há menos de um minuto DS mt 
A implementação desta tarefa vai de encontro à análise de 


requisitos detalhada no seguinte documento: Funcionamento da 
Sincronia de Dados 


4 Editar Q Tempo de trabalho Observar Copiar im Excluir 


Figura 9.11: Exemplo de nota relacionada ao documento sobre a sincronia dos dados. 


9.4 Arquivos: gerencie arquivos do projeto 


Todo projeto em algum momento terá arquivos. Pode ser um termo 
de abertura, um contrato, um modelo da base de dados, entre 
outros. 


Parecido com o módulo de documentos, este módulo possui como 
diferencial a capacidade de gerenciar arquivos, controlando o 
número de downloads e também permite que sejam agrupados por 
versões, caso existam no projeto. Outra diferença é que os arquivos 
podem apenas ser enviados e excluídos. Desta forma, se torna ideal 
para a liberação de versões de softwares, por exemplo. 


Utilize o módulo de arquivos para documentos finalizados, como 
contratos, versões para download entre outros. Para documentos 
que necessitam de alteração constante, o mais indicado é o módulo 
de documentos mesmo. 


Adicionando arquivos 


Ao adicionar um arquivo basta selecioná-lo e colocar uma descrição 
caso desejar. 


Novo arquivo 











Arquivos 4 Mina Vermelha Desktop 1.5.exe [Mina Vermelha Desktop 1.5 








Escolher arquivos | Nenhum arquivo selecionado (Tamanho máximo: 24,5 MB) 

















Adicionar 








«& Arquivo adicionado 


Arquivos O Novo arquivo 
Arquivo Data Tamanho D/L MDS 
Mina Vermelha Desktop 1.5.exe 15/04/2025 14,3 MB O bfc962190cb5017734420ddf62ff9a54 4 
17:17h 


Figura 9.12: Os arquivos cadastrados exibirão o número de downloads e um Hash MDS. 
Criando ligações para arquivos 


Para criar ligações para arquivos, é necessário ter a URL de 
download do arquivo e utilizar o seguinte padrão: "Descrição":URL 


Exemplo: 


Com base no “Termo de Abertura do 
Projeto":/redmine/attachments/download/1/arquivo.pdf temos como premissa 
que o projeto deverá funcionar na maioria dos smartphones atuais 


Desta maneira, estaremos criando um link para o primeiro arquivo 
adicionado. 


Historico 
Atualizado por Gerente dos Projetos há menos de um minuto 4 81 


Com base no Termo de Abertura do Projeto temos como 
premissa que o projeto deverá funcionar na maioria dos 
smartphones atuais 


4 Editar Cà Tempo de trabalho Observar Copiar Excluir 


Figura 9.13: Adição de nota em tarefa relacionando um documento. 


9.5 Wiki: gestão de conhecimento colaborativo 


Wikis são sistemas que servem para criar páginas dinâmicas, 
permitindo estabelecer relacionamentos entre elas. Este é o 
conceito básico de um sistema do tipo Wiki. O Redmine possui 
também um sistema de Wiki individual para cada projeto. Apesar de 
parecer simples, o sistema de Wiki do Redmine possui alguns 
recursos poderosos que podem auxiliar bastante durante o 
gerenciamento dos projetos. 


Além de relacionar outras páginas, o sistema de Wiki do Redmine 
permite também relacionar projetos, tarefas, versões, entre outros. E 
possui também um gerenciamento de histórico, onde é possível 
comparar revisões, reverter e mais. 


Um uso muito comum para as Wikis é centralizar manuais e 
documentações e, por manter histórico das modificações, é muito 
útil para processos de certificação como ISO, MPS.BR entre outros. 


Adicionando páginas Wiki 


Para adicionar/editar a Wiki do seu projeto, basta abrir a aba Wiki, 
então você verá uma tela semelhante à imagem a seguir: 


Wiki 


Il 
In 
iil 


Editar || Pré-visualizar BIFIUISIC Hi || H2 || H3 | |:= ||}= 


hi. Documentações - Mina Vermelha 


h2. [[Padrões de codificação]] 
h2. Documentações do Projeto 
* documentgl 


* document#2 
* document&3 


Comentário |Criando estrutura inicial da Wiki do projeto Mina Vermelha App 
Arquivos [ Escolher arquivos | Nenhum arquivo selecionado (Tamanho máximo: 5 MB) 





Figura 9.14: Edite livremente criando as páginas que achar necessário. 


Esta será a página inicial; através dela é que você criará as outras. 
Basta utilizar o nome da página que você deseja criar entre dois 
colchetes, como no exemplo da imagem, [[Padrões de Codificação]], 
que gerará um link para a criação da nova página com este nome. 


Documentações - Mina Vermelha 
Padrões de codificação 
Documentações do Projeto 


« Funcionamento da Sincronia de Dados 
« Padrão de Criptografia 
« Modelagem da Base de Dados 


Figura 9.15: Links em vermelho significam que as páginas ainda não foram criadas. Basta 
clicar neles para criá-las. 


Macros: a funcionalidade secreta 


Como foi comentado anteriormente, o Redmine possui alguns 
recursos poderosos que fazem com que o sistema de Wiki seja mais 
ágil. Um dos principais é a existência de macros, que se tratam de 
códigos que podem ser adicionadas a páginas e que executam 
ações dentro do Redmine. 


As macros padrões existentes no Redmine permitem: 


e Inclusão de páginas dentro de outras páginas (include) 

e Geração de miniaturas (thumbnail) 

e Criação de links para exibir e ocultar mais detalhes em um texto 
(collapse) 

e Listagem de páginas filhas (child pages) 


Além disso, existem plugins que habilitam novas macros. Para ter 
uma listagem das macros disponíveis, é possível utilizar a macro 
{{macro_list}}. 


Para exemplificar, vamos supor que temos uma página chamada 
menupadrao , onde criamos um menu personalizado para a nossa 
Wiki. Desta forma, basta utilizar a seguinte macro para adicionar o 
menu em qualquer página: 


{{include(menupadrao)}} 


E então as páginas utilizarão o mesmo menu, facilitando as 
manutenções. 


Wiki » 4 Editar Yr Observar (8) Bloquear É Renomear fi Excluir 
Padrões de Codificação 


Classes | Variáveis | SQLs | Espaçamentos | Comentários 


Para facilitar o trabalho de todos, temos uma série de padrões que auxiliam 

a forma como desenvolvemos nossos códigos. Desta forma, buscamos que os 
códigos sejam os mais claros possíveis e facilitem a manutenção futura 

por qualquer um da nossa equipe. Utilize o menu acima para conhecer mais 
sobre os nossos padrões. 


</> 





Figura 9.16: Exemplo do uso de include, onde o menu foi criado em outra página. 


Sidebar 


O próprio Redmine utiliza também uma macro internamente, 
incluindo uma página chamada sidebar, que é utilizada na lateral da 
Wiki do projeto. 


Como padrão, esta página não existe. Para exemplificar, vou criar 
esta página utilizando também as macros colapse e thumbnail com 
o seguinte conteúdo: 


h1. Menu 


((collapse(Padrões de Codificação) 
[[Classes]] 

[[Variáveis]] 

[[SQLs]] 

* 

((collapse(Links Úteis) 

"Mina Vermelha" :http://www.minavermelha.f00/ 


“"wWebmail":http://webmail.minavermelha.f90/ 
"Senhas" :http://minavermelha.f900/senhas.txt 


}} 
p=. {{thumbnail(logo.png, size=40)}} 


Desta forma todas as páginas da Wiki do projeto terão o seguinte 
menu lateral: 


Fóruns Arquivos Configurações 


Excluir Histórico Me nu 





+ Padrões de Codificação 


. Classes 
Variáveis 
- SOLs 


z Links Úteis 
« Mina Vermelha 


« Webmail 
« Senhas 


q 
g, 










Figura 9.17: Exemplo do uso da Wiki Sidebar. 


O interessante do uso do módulo de Wiki para documentações é 
que todos os membros do projeto podem ir colaborando e 
adicionando informações e é mantido um histórico de todas as 


modificações. 


9.6 Referenciando itens do Redmine 


Como vimos nos tópicos anteriores, existe uma série de padrões 
que nos permite relacionar itens entre si. É importante conhecer e 
utilizar esta funcionalidade, pois ela permite uma rastreabilidade 
maior entre as informações existentes no Redmine, garantindo um 


maior controle sobre os projetos. 


A seguir, temos uma relação das possibilidades de relacionamentos 


existentes: 


Item 
Tarefas 
Tarefas com o título 
Notas em tarefas 
Documentos 
Documentos (alternativa) 
Versão 
Versão (alternativa) 
Fórum 
Mensagens de fóruns 
Projeto 


Projeto (alternativa) 


Forma de utilização 
#123 
HH123 
4123-1 OU #123#note-1 
document#5 
document:Titulo 
version#4 
version:1.4beta 
forumk3 
messaget123 
projectH2 


project :nome 


Item Forma de utilização 


Notícias news#1 

Página Wiki [[wiki]] 

Tópico de uma página Wiki [[wikigtopico]] 
Revisões (commits) r123 

Arquivos de repositórios source: caminho/do/arquivo 


Arquivos de repositórios (revisão 2) | source:caminho/do/arquivoQz 
Arquivos attachment:arquivo.zip 
Uma lista mais completa e constantemente atualizada da sintaxe 


adotada pelo Redmine pode ser encontrada no seguinte link do site 
oficial: 


http://www.redmine.org/help/pt-br/wiki syntax detailed.html 
Conclusão 


Com este capítulo, encerramos a primeira parte deste livro. O 
objetivo aqui foi fazer com que você conhecesse melhor o Redmine. 


Assim como no final do capítulo Criando seu primeiro projeto, 
teremos mais uma atividade para fixar o que vimos até então. Utilize 
o QR Code a seguir com o seu celular, ou então acesse o seguinte 
endereço: http://bit.ly/redlab2/ 





Figura 9.18: http://bit.ly/redlab2. 


Siga as instruções existentes no link e então prossiga com a leitura. 
A partir do próximo capítulo vamos nos aprofundar na arte de 
gerenciar projetos com o Redminel! 


Parte B: Gerenciando projetos 
com o Redmine 


CAPÍTULO 10 
Gerenciando projetos 


A partir de agora vamos focar no gerenciamento de projetos, 
identificando as melhores maneiras de utilizar o Redmine para 
facilitar na gerência, independente da metodologia adotada. 


Existem várias maneiras de gerenciar projetos e possivelmente você 
já ouviu falar de várias, ou talvez até tenha aprendido na faculdade 
que para gerenciar projetos é necessário criar uma série de 
documentos. 


O fato é que, na prática, as coisas podem ser totalmente diferentes, 
e talvez as demandas não permitam que sobre tempo para a criação 
de todos os documentos necessários. 


Por isso, a partir de agora vamos analisar duas formas mais comuns 
de gerência de projetos: o gerenciamento clássico, que muitos 
aprendem na faculdade e poucos usam totalmente, e o 
gerenciamento ágil, que poucos viram na faculdade mas muitos 
utilizam. 


A ideia aqui não é defender uma forma ou outra, mas sim 
apresentar as características de cada uma delas, e como utilizá-las 
em conjunto com o Redmine. 


A escolha de qual metodologia utilizar deve ser definida pelas 
características do cenário onde será adotada. Pois o ideal não é 
adaptar as formas de trabalho à metodologia, e sim, adaptar a 
metodologia ao seu ambiente de trabalho. 


10.1 Gerenciamento clássico 


O gerenciamento clássico ou gerenciamento tradicional é mais 
conhecido por ser a forma de gerenciar projetos apresentada pelas 
universidades. Além disso, é também considerada como base para 
muitas certificações. 


Ciclo de vida 


Podemos caracterizar o gerenciamento clássico pela existência de 
etapas bem definidas, onde temos fases como: 


Processo de iniciação 


Fase em que temos a coleta de requisitos com o cliente, 
formalização do termo de abertura entre outros documentos para 
manter o escopo do projeto bem definido. 


Processos de planejamento 


Fase em que são realizadas análises sobre todos os dados 
coletados inicialmente, seguindo os detalhes acordados no termo de 
abertura, e focando no gerenciamento do escopo nas etapas 
seguintes. 


Processo de execução 


Fase em que o que foi planejado é de fato executado, respeitando 
ao máximo a definição do escopo realizada na etapa de 
planejamento. 


Processo de encerramento 


Trata-se da fase final, em que o que foi executado é validado de 
acordo com o que foi definido no termo de abertura, podendo 
representar a entrega de um produto real, ou então o retorno a 
alguma etapa anterior caso a execução não seja aprovada. 


O Redmine possui algumas funcionalidades chaves que facilitam o 
gerenciamento clássico do ciclo de vida de projetos como veremos 
nos tópicos a seguir: 


Gerenciamento de escopo 


Gerência de escopo envolve garantir que o projeto inclua todo o 
trabalho exigido para completá-lo com sucesso. Para isso, é 
essencial uma análise de requisitos bem executada, realizando a 
coleta de informações com os interessados. 


Desta forma, é possível definir o escopo funcional do projeto, ou 
seja, as funcionalidades chaves do projeto, de forma que o 
solicitante entenda. 


Com base nesse escopo funcional, é possível elaborar então o 
escopo técnico, que envolve o detalhamento técnico de como as 
funcionalidades serão implementadas pela equipe responsável. 


Podemos utilizar como exemplo de escopo funcional o fórum criado 
no capítulo Adicionando mais informações aos seus projetos. 


Fóruns » Definição do Escopo » 

Funcionalidades iniciais Ýr Parar de observar Ọ Responder 4 Editar fm Excluir 
Adicionado por Gerente dos Projetos 3 minutos atrás 

Olá, 

estou criando este tópico para discutirmos as funcionalidades iniciais do projeto. 


O que vocês acreditam que seria essencial para o funcionamento do aplicativo? 


O Respostas (1) 
RE: Funcionalidades iniciais - Adicionado por Analista menos de um minuto atrás 2/2 6 


Acredito que uma tela de /ogin é algo essencial para que cada usuário acesse apenas os seus 
próprios dados. 


Como vocês acham que deve funcionar o cadastro destes usuários? 
(1-1/1) 


Responder 


Figura 10.1: Definição do escopo funcional através do módulo de fórum. 


Através deste fórum, a equipe da empresa Mina Vermelha Sistemas 
pôde elaborar o escopo técnico, onde podemos utilizar o documento 
criado no capítulo Tarefas como exemplo. 


Funcionamento da Sincronia de Dados 4 Editar fi) Excluir 


Documentação técnica 
15/04/2025 


A sincronia de dados do projeto Mina Vermelha App funcionará através de uma API REST, 
que trabalhará com um Token criptografado, garantindo assim a segurança das 
informações. 


Esta API possuirá um versionamento para garantir a compatibilidade mesmo com versões 
desatualizadas do aplicativo, pois podem existir usuários com versões antigas do aplicativo. 


Métodos Principais 
Login 
Este método terá a função de realizar a autenticação dos usuários 


« URL: /login 
. Parametros: 


* usuario: Nome do usuario informado na tela de login 
* hash: Hash da senha informada na tela de login 
« verificador: Hash de verificação gerado pelo aplicativo 


+ Retornos: 


* 200: Login efetuado com sucesso. 
e 403: Acesso negado. 
e 404: Usuário não encontrado. 


Figura 10.2: Definição do escopo técnico através de documento. 
Gerenciamento de tempo 


O tempo é um dos recursos mais importantes para a realização do 
projeto e afetará diretamente a qualidade ou mesmo a entrega do 
projeto. Por isso, é importante saber medir e gerenciar o tempo de 
maneira correta. 


O Redmine possui algumas ferramentas que podem ser úteis 
durante este processo. Um exemplo é o controle de tempo 
apresentado no capítulo sobre as Tarefas. 


Como o lançamento correto dos tempos de trabalho, é possível 
coletar uma série de informações para auxiliar no gerenciamento do 


tempo. 
Gráfico de Gantt 


Uma ferramenta muito útil para realizar o gerenciamento de tempo é 
o gráfico de Gantt. Publicado por por Henry Gantt em 1919, serve 
para auxiliar no controle de produção, distribuindo tarefas em linhas, 
onde o eixo horizontal representa o tempo percorrido. Hoje em dia, o 
Gráfico de Gantt é um dos gráficos mais utilizados para estimativa 
de prazos. 


Todos os projetos no Redmine possuem o módulo para geração de 
Gráfico de Gantt disponível, permitindo a geração dinâmica de um 
gráfico contendo detalhes das tarefas existentes no projeto com o 
relacionamento entre elas. 

















Sprint 01 42 Editar f Excluir 
Filtros 
» Opções 
Aproximar zoom = Afastar zoom 
3 meses a partir de | Março v||2025 {~| Aplicar Q Limpar RA > 
2025-4 
14 15 16 17 
34 718/191011 14 16/17/18 21/22/23/24 
T T T S T 
DA Mina Vermelha App + 4 Mina Vermelha App 
[67] Sprint 01 Qro + Sprint 01 55% 
=] Suporte #1: Realizar o Levantamento dos Requisitos e ,, 
E : Entrevistar o Cliente Fulado E Fecho co 
ks] Suporte #3: Entrevistar o Cliente Sicrano BE 


Figura 10.3: Gráfico de Gantt com subtarefa. 


Desta forma, torna-se mais ágil a análise do cronograma do projeto, 
permitindo uma visão mais clara para a definição de prazos. 


DICA: ESTIMANDO PRAZOS 


O gráfico de Gantt auxilia muito na hora de estimar prazos de 
conclusão de atividade e/ou projetos. Através dele você poderá 


visualizar as atividades previstas, em andamento e atrasadas 
entre todos os projetos, e analisar em que momento outras 
atividades poderão ser desenvolvidas. 





Nos próximos capítulos, vamos detalhar mais a gerência de tempo e 
outras características do gerenciamento clássico. 


10.2 Gerenciamento ágil 


Como alternativa ao gerenciamento clássico, muitas pessoas estão 
adotando atualmente o gerenciamento ágil como a solução para 
trazer agilidade a qualquer cenário. De fato, ele traz uma série de 
vantagens, porém, é importante adotá-lo com cautela para não 
prejudicar a continuidade dos projetos. 


Em resumo, o gerenciamento ágil tem como objetivo focar na 
agilidade do desenvolvimento, dando menos importância a 
documentações e outros artefatos utilizados pelo gerenciamento 
clássico. E passou a ser mais utilizado nas áreas de 
desenvolvimento de software após a divulgação do Agile Manifest, 
ou Manifesto Ágil, que estabelece uma série de princípios para um 
possível aumento da produtividade de equipes. 


Com base neste manifesto, equipes de desenvolvimento acabam 
adotando metodologias para facilitar a adoção destes princípios. 
Vamos focar em duas principais metodologias que são muito 
utilizadas em conjunto com o Redmine: o Scrum e o Kanban. 


Kanban 


Na década de 40, uma empresa japonesa começou a estudar o 
funcionamento de mercados, para implementar a mesma lógica de 
controle de estoque em suas fábricas. Assim como nos mercados os 
estoques são repostos de acordo com as necessidades dos clientes, 
sua linha de produção passou a ser alinhada com a demanda do 
mercado. 


Esta empresa era a Toyota, e foi desta forma que surgiu o sistema 
Kanban. 


Utilizando post-its (ou outro meio) para controlar o fluxo de trabalho, 
muitas empresas de software atualmente utilizam o Kanban para 
controlar suas atividades de forma ágil. 


Atividades ordenadas por Atividades em Atividades prontas para serem 


prioridade desenvolvimento entregues 





Figura 10.4: Exemplo de quadro representando o Kanban. 


No Kanban basicamente temos a classificação das atividades em 3 
situações: 


e A fazer (To Do) 
e Fazendo (Doing) 
e Pronto (Done) 


Todas as atividades que precisam ser realizadas são organizadas 
por ordem de prioridade e classificadas como A Fazer. 


No momento que a atividade for iniciada, passará a ser classificada 
como Fazendo, e ao ser finalizada, passará à situação Pronto. A 
ideia principal deste modelo é que o foco seja concentrado em 
apenas uma tarefa por pessoa, até que esta esteja pronta. 


Scrum 


Semelhante ao Kanban, o Scrum é uma metodologia utilizada com 
frequência por equipes de desenvolvimento de software para o 
desenvolvimento ágil. E da mesma forma, é comum a utilização de 
post-its para o acompanhamento da situação das atividades. 


No caso do Scrum, os projetos são divididos em ciclos chamados 
Sprints, e no início de cada um destes ciclos são definidas as 
tarefas que serão desenvolvidas, a prioridade de cada uma, além de 
ser realizada uma estimativa de tempo para o desenvolvimento. 


Ao iniciar o desenvolvimento de uma Sprint, cada pessoa 
desenvolve uma tarefa por vez, semelhante ao Kanban, porém, ao 
finalizar o desenvolvimento a atividade é enviada para testes, onde 
uma outra pessoa realizará a validação para considerar a tarefa 
como pronta. 


A Fazer Fazendo Testar Testando Pronto 


Atividades Atividades em Atividades Atividades em Atividades validadas e 
planejadas na desenvolvimento | desenvolvidas testes prontas para serem 
Sprint ordenadas aguardando entregues 
por prioridade validação 


Impedimento 


Tarefas com 
desenvolvimento impedido 
por algum motivo 





Figura 10.5: Semelhante ao Kanban, é comum a utilização de quadros para acompanhar o 
andamento das tarefas no Scrum. 


O termo Sprint será usado em outros capítulos deste livro, caso 
você não esteja familiarizado com o conceito, entenda como 
versões lançadas periodicamente. 


Tomando como base estas duas metodologias de desenvolvimento, 
veremos nos próximos capítulos alguns ajustes possíveis no 
Redmine para facilitar o processo de gerenciamento. 


10.3 Aplicando a teoria na prática 


Até então vimos algumas características do gerenciamento clássico 
e do gerenciamento ágil. Como foi comentado no início deste 
capítulo, a ideia não é defender nenhuma das formas de 
gerenciamento, mas tentar expor as vantagens e desvantagens que 
cada uma dessas pode apresentar, e demonstrar como o Redmine 
pode atender em todos os casos, independente do cenário onde 
será utilizado. 


Para facilitar a visualização da aplicação destas metodologias, 
vamos supor que a nossa empresa Mina Vermelha possui 3 
produtos em funcionamento, cada um com suas características que 
acabam influenciando na escolha das estratégias de gerenciamento. 


Primeiro produto: sistema web 


Há 10 anos, a empresa Mina Vermelha criava o seu primeiro 
produto, que se tratava de um sistema web, que fez com que a 
empresa conseguisse sobreviver nos seus primeiros anos de vida. 


Por se tratar de um sistema web, onde todo o código fica 
centralizado nos servidores da empresa, o desenvolvimento é 
dinâmico, pois constantemente são feitas atualizações no sistema, 
muitas vezes sem que os clientes percebam. 


Como os clientes pagam mensalidade por esse serviço, e utilizam 
constantemente o sistema, são realizadas várias solicitações, que 
acabam chegando para a equipe responsável através de 
solicitações no Redmine. 


Isso faz com que ocorram mudanças frequentes, tornando 
praticamente impossível planejar com exatidão o que será 
desenvolvido a cada semana, uma vez que os requisitos mudam 
constantemente. 


Segundo produto: sistema desktop 


Depois de 2 anos de funcionamento do sistema web, a empresa 
decidiu apostar também em uma versão executável do seu sistema. 
Porém, um dos principais problemas enfrentados pela nova equipe 
foi acostumar os clientes e demais colegas da empresa à liberação 
de versões periódicas e não mais imediatas como na versão web. 


Hoje, depois de 8 anos de funcionamento, a equipe de 
desenvolvimento desktop conta com vários desenvolvedores, alguns 
que participaram da criação do sistema, e outros que entraram para 
equipe há menos de um ano. 


Terceiro produto: Mina Vermelha App 


E atualmente, a Mina Vermelha pretende criar uma versão 
alternativa do seu sistema, focando em dispositivos móveis. 


Uma das características desse novo projeto é que os requisitos 
ainda não estão muito claros, uma vez que o projeto está sendo 
desenvolvido em segredo por causa dos concorrentes, e por isso 
não foi realizada a análise de requisitos com os clientes atuais das 
versões web e desktop. 


Além disso, a direção estima que o projeto levará pelo menos um 
ano para ser comercializado. 


10.4 Escolhendo a metodologia 


Identificou-se com algum dos cenários? Qual a melhor metodologia 
para cada um deles? 


O fato é que não existe metodologia certa ou errada, mas sim 
aquelas que trarão mais vantagens do que desvantagens. Todas 
dependerão da aceitação dos participantes do projeto 


Burocratização em excesso 


No nosso primeiro exemplo, temos um sistema web. Nada impede a 
Mina Vermelha de adotar o Scrum como metodologia de 
gerenciamento, inclusive, existem muitas agências web que o 
utilizam. Porém, neste ponto devemos analisar todos os detalhes. 


A adoção do Scrum traz consigo as Sprints, fazendo com que haja 
um tempo maior para a liberação das atualizações. Além disso, 
como os requisitos mudam constantemente, o planejamento das 
Sprints pode ser prejudicado, fazendo com que boa parte do tempo 
seja gasto com tarefas não previstas, ou então, fazendo com que os 
clientes aguardem até as próximas Sprints para terem seus ajustes 
no cronograma da equipe de desenvolvimento. 


Todos estes fatores afetam e muito o padrão adotado até então, e 
podem prejudicar a saúde financeira da empresa, uma vez que o 
produto garantiu sua sustentabilidade por um bom tempo, e os 
clientes estão acostumados a terem suas solicitações atendidas em 
pouco tempo. 


Algo semelhante pode ocorrer adotando os padrões clássicos de 
gerenciamento de projetos, já que os requisitos podem se alterar 
toda semana. Itens como termo de abertura do projeto, definição 
de cronograma, entre outros, acabariam muitas vezes tomando 
mais tempo do que o desenvolvimento das atividades. 


Neste caso, talvez seria interessante adotar a versão mais light do 
Scrum, ou seja, o Kanban. E além disso, realizar algumas 
mudanças para deixar os processos mais enxutos, como controlar 
melhor as solicitações dos usuários, priorizando apenas 
funcionalidades solicitadas por mais de um cliente, por exemplo. 
Para cenários semelhantes a este, recomendo também a leitura do 
livro gratuito Getting Real - Caindo na Real, que pode ser facilmente 
encontrado na internet. 


Perdendo desenvolvedores experientes 


Já no caso do sistema desktop, as desvantagens apresentadas 
anteriormente do Scrum e do gerenciamento clássico, podem ser 
consideradas como vantagens neste cenário. 


Como existe a liberação de versões periódicas, esses períodos 
podem servir de base para a duração de Sprints. 


Além disso, como os clientes do sistema desktop tiveram desde o 
início a percepção das liberações de versões periódicas, os 
requisitos não mudam com tanta frequência, permitindo a 
elaboração de documentações para atender as etapas do 
gerenciamento clássico sem dificuldades. 


Apenas há um fator que muitas vezes passa despercebido ao se 
adotar o Scrum. Como existem desenvolvedores que participaram 
da criação do produto e outros não tão experientes, e a adoção do 
Scrum faz com que todos trabalhem em conjunto em tarefas de 
forma aleatória, a adaptação dos novos desenvolvedores será mais 
rápida, porém, fará com que desenvolvedores experientes 
empenhem seus tempos desenvolvendo atividades de baixa 
complexidade. 


Isso faz com que alguns desenvolvedores fiquem desmotivados, 
como se tivessem voltado à época em que apenas estivessem 
apertando parafusos sem poder trabalhar sozinhos no produto final, 
como estavam acostumados. Além disso, depois de anos 


trabalhando para deixar o produto da empresa funcionando, ainda 
são recompensados com a necessidade de reportar diariamente o 
que estão fazendo. 


O Scrum é uma metodologia excelente, porém, deve-se tomar 
cuidado com a forma como é adotado, pois pode afetar a 
sustentabilidade da empresa, causando a saída de bons 
profissionais, entre outras coisas. 


Em cenários semelhantes a esse, é interessante até trabalhar com o 
Scrum em paralelo ao gerenciamento sem Scrum, deixando parte 
da equipe trabalhando em projetos de longo prazo por exemplo, 
uma vez que pode haver atividades que alguns profissionais 
executariam em menor tempo e com mais qualidade já focando no 
resultado a longo prazo. 


Projetos de longo prazo 


Para finalizar, temos o projeto Mina Vermelha App, que não possui 
nenhum cronograma de versões definido ainda, e que, por decisões 
estratégicas da empresa, possui uma etapa de análise de requisitos 
restrita e quase inexistente. 


Nesse caso, por se tratar de uma versão alternativa aos outros dois 
produtos já existentes, pode-se utilizar como base as solicitações de 
funcionalidades já registradas no Redmine. Muitas das solicitações 
recorrentes podem se tornar funcionalidades chaves do novo 
produto. 


Com base nessas funcionalidades, seria possível optar pelo 
gerenciamento clássico, definindo então o escopo técnico para se 
chegar a um possível cronograma de desenvolvimento. 


Priorizando as funcionalidades chaves, seria possível também 
definir um cronograma de entregas. E em alguns casos, antecipar o 
lançamento do produto com poucas funcionalidades para então 
fazer uma nova análise de requisitos com clientes reais. 


Conclusão 


Os exemplos de soluções citadas anteriormente não são regras, 
mas apenas possibilidades. Existem vários fatores a serem 
analisados, e como foi comentado anteriormente, a aceitação da 
equipe é um dos fatores principais. O que funciona bem para uma 
equipe não quer dizer que funcionará semelhante para outra. 


Assim como os programas analisam as diversas variáveis, ao 
escolher uma metodologia, deve-se tomar o mesmo cuidado. Muitas 
vezes, existem consultores que não conhecem a realidade da 
empresa e do dia a dia dos programadores e logo sugerem a 
adoção da metodologia X sem saber todo o histórico do cenário. 
Não é assim que as coisas deveriam funcionar. 


Projetos são coisas mutáveis e, ao adotar uma metodologia 
diferente, existirão impactos positivos e negativos. No momento em 
que um projeto passa a ser controlado por Sprints, por exemplo, 
haverá alterações no cronograma de entregas, na motivação dos 
desenvolvedores, na qualidade dos produtos, e no futuro do projeto 
e da empresa. O ideal seria ao adotar uma metodologia, definir uma 
data futura para rever a mesma e ajustá-la. 


Além disso, atualmente existe o entendimento de que 
gerenciamento ágil e gerenciamento clássico são duas coisas 
opostas. Mas quem falou que não podemos adotar um meio termo? 


Existem várias possibilidades, cabe a você identificar como usar as 
várias metodologias de gerenciamento de projetos disponíveis para 
fazer os seus projetos evoluírem para outro nível. 


Agora que vimos um pouco sobre as metodologias de 
gerenciamento de projetos, vamos utilizá-las em conjunto com o 
Redmine. 


CAPÍTULO 11 
Versões 


Como vimos no capítulo anterior, existem várias formas de gerenciar 
projetos, e o Redmine está pronto para auxiliar, independente da 
metodologia adotada. 


Prosseguindo com o nosso caso de estudo, o gerente de projetos da 
Mina Vermelha decidiu utilizar o Scrum para gerenciar o fluxo de 
atividades do sistema desktop. 


Como as atualizações do software são liberadas uma vez por mês, 
foi aproveitado este padrão para a definição de Sprints mensais. 
Desta forma, o que é desenvolvido pela equipe durante a Sprint e é 
validado acaba se transformando na versão final. 


Para fazer esta separação de tarefas por Sprints, o Redmine conta 
com um controle de versões, que permite o planejamento de 
versões do projeto. Desta forma, todas as tarefas alocadas para 
uma Sprint podem ser atribuídas para a versão correspondente a 
ela. 


11.1 Adicionando versões 


Para adicionar versões ao seu projeto, basta acessar a aba 
Configurações do seu projeto, acessar a subaba Versões, e então 
clicar em Nova versão. 


Nova versão 


Nome * 








Descrição [Versão correspondente à Sprint 01 
Data 


Compartilhamento | Sem compartilhamento 





Figura 11.1: Tela de criação de versões. 


O único campo obrigatório é o nome da versão. Este nome poderá 
ser alterado em outro momento. O campo Data serve para informar 
a data prevista para a versão. 





ACSC LL FT, s C ETs Lia a 6 | DT TT o a a Ceia oits C Deo LL OR NE C Configurações 


« Criado com sucesso. 





Configurações 


Informações || Módulos || Membros | Versões || Categorias das tarefas || Wiki | Repositórios || Atividades (registro de horas) 


Versão Data Descrição Situação Compartilhamento 
Sprint 01 30/04/2025 Versão correspondente à Sprint 01 aberto Sem compartilhamento 4 Editar fã Excluir 


Q Nova versão Fechar versões concluídas 


Figura 11.2: Tela de criação da mensagem. 


Após adicionar a primeira versão, será exibido um campo para 
escolha da versão ao adicionar tarefas e outros itens ao projeto. 


DICA: VERSÃO BACKLOG! 


Para facilitar o processo de planejamento das versões, é 
interessante criar uma versão chamada Backlog, para 


centralizar as tarefas que devem ser alocadas para versões 
futuras. Desta forma, ao planejar uma nova versão, basta 
analisar as atividades com maior prioridade do backlog. 





Situação 


Ao editar uma versão, há o campo situação que altera o 
comportamento das versões em questão: 


e Aberto: sem restrição. Situação padrão. 

e Bloqueado: não é possível adicionar novas tarefas à versão. 

e Fechado: não é possível adicionar novas tarefas à versão. 
Além disso, as tarefas já fechadas que estiverem na versão não 
poderão mais ser abertas. 


Desta forma, é interessante bloquear ou fechar versões antigas, 
para que os usuários encontrem as versões atuais de forma mais 
rápida ao alterar uma tarefa ou outro item. 


Compartilhamento 


Uma versão pode ainda ser compartilhada com outros projetos, 
fazendo com que tarefas de outros projetos possam ser adicionadas 
à versão compartilhada. 


Existem 4 tipos de compartilhamento, sendo que cada um deles 
oferecerá um nível de acesso diferente à versão: 


e Com subprojetos: todos os subprojetos do projeto onde a 
versão está sendo criada terão acesso a ela. 

e Com a hierarquia do projeto: todos os subprojetos e projetos 
superiores terão acesso à versão. 


e Com a árvore do projeto: todos os subprojetos, projetos 
superiores e subprojetos do projeto superior (projetos irmãos) 
terão acesso à versão. 

e Com todos os projetos: todos os projetos do Redmine terão 
acesso à versão (opção disponível apenas para 
administradores). 


Para melhor entendimento desta lógica, veja a tabela a seguir: 


Projetos Projetos 


Tipo Subprojetos é INES Outro: 
superiores irmãos 

Subprojetos Permitido Sem Pem em 
acesso acesso acesso 

Hierarquia Permitido Permitido sem Spm 
acesso acesso 

Árvore Permitido Permitido Permitido Sem 
acesso 
Todos Permitido Permitido Permitido Permitic 


> 


Esse compartilhamento pode ser útil quando em uma mesma Sprint 
são desenvolvidas tarefas de vários projetos. 


No caso em que uma sprint envolver tarefas de um projeto e 
também de um subprojeto, é interessante selecionar a opção com 
subprojetos. 


Outro exemplo é a versão Backlog, que pode ser compartilhada 
com todos os projetos, para que tarefas de todos os projetos 
possam ser atribuídas a ela. 


Nestes casos é importante escolher o tipo de compartilhamento que 
melhor atenderá às necessidades da equipe. 


11.2 Planejamento 


Ao adicionar uma versão ao projeto, é habilitada a aba 
Planejamento, mostrando o andamento das versões existentes no 
projeto. O percentual de conclusão da versão será calculado com 
base nas tarefas adicionadas na versão. 


Planejamento 

@ Sprint 01 

Previsto para mais de 6 anos (30/04/2025) 
Versão correspondente à Sprint 01 


50% 


3 tarefas (1 fechada — 2 abertas 


Figura 11.3: Aba de planejamento mostrando detalhes da versão da Sprint 01. 


Desta forma, será possível acompanhar o andamento das Sprints 
durante sua execução. Caso uma tarefa não seja desenvolvida na 
Sprint 01, esta poderá ser movida para a Sprint 02 por exemplo. 


Da mesma forma, é possível organizar tarefas e itens em versões 
não só em casos onde o Scrum é adotado, mas em outros tipos de 
metodologia. Podemos por exemplo criar uma versão chamada 
"Levantamento de Requisitos”, por exemplo, no caso do 
gerenciamento clássico, onde o gerenciamento de tempo também 
possui grande significância. 


E por ser flexível, o Redmine não obriga que sejam utilizadas 
versões para o gerenciamento, podendo existir projetos sem 
versões. Mas caso você queira visualizar e gerenciar os projetos e 
seus itens de forma mais eficiente, esta é uma boa prática a ser 
adotada. 


Conclusão 


Com este capítulo, vimos como separar as tarefas em versões. Nos 
próximos capítulos, veremos que esta separação nos trará uma 
série de vantagens ao gerenciar e analisar os dados armazenados 
no Redmine. 


CAPÍTULO 12 
Usuários 


De nada adianta possuir um sistema eficiente de gerenciamento de 
projetos se apenas uma pessoa o acessa sem compartilhar com 
outros envolvidos com o projeto. Por isso, agora veremos como 
adicionar novos usuários ao Redmine, e como gerenciá-los. 


No caso da Mina Vermelha, existem diversas equipes, a maioria 
trabalha em conjunto com outras. Este é o caso da equipe de 
suporte, que recebe as atividades e repassa para a equipe de 
infraestrutura ou então para uma das 3 equipes de desenvolvimento. 


Para facilitar este processo de organização das equipes, a partir 
deste capítulo, veremos como organizar os usuários do Redmine. 


12.1 Adicionando usuários 


No capítulo Preparando o ambiente, realizamos o acesso ao 
Redmine utilizando um usuário pré-cadastrado com permissões de 
administração. Através dele será possível adicionar novos usuários. 


Para adicionar novos usuários, acesse a opção Administração no 
menu superior, e então clique em Usuários. Nesta tela será 
possível visualizar e editar os usuários já cadastrados, assim como 
cadastrar novos usuários através da opção Novo usuário. 


Usuários » Novo usuário 


Informações Notificações por e-mail 





ario * 
Usuário * Ineo 








| Somente de tarefas que observo ou que esteja envolvidi ~ 











* 
Nome * Thomas 














“| Eu não quero ser notificado de minhas próprias modificações 








Sobrenome * |Anderson 








































































































E-mail * neo(D matrix Preferências 
Idioma | Hebrew (nna) v Ocultar meu e-mail [4 
Administrador [|] Fuso-horário = 
ue Visualizar comentários ági v 
Autenticação Em ordem cronológica 
Senha * F. Alertar-me ao sair de |V 
uma página sem salvar o 
Ei E texto 
H a + 
Confirmação * |..cessses Fonte usada para áreas [Fonte padrão 7 
Gerar senha de texto 
É necessário alterar sua [] 








senha na próxima vez 
que tentar acessar sua 
conta 











v| Enviar informação da nova conta para o usuário 

















Criar || Criar e continuar 








Figura 12.1: Tela para cadastro de novos usuários. 


Além disso, os usuários podem realizar o seu cadastro 
manualmente, através da tela inicial, dependendo das configurações 
do seu Redmine, como vimos no capítulo Configurações iniciais. 


12.2 Adicionando membros ao projeto 


Após adicionar o usuário, ele terá permissão apenas para acessar o 
Redmine, e acessar os projetos públicos. Para que o usuário faça 
parte do projeto é necessário transformá-lo em membro do projeto. 


Para fazer isto é muito simples, basta acessar as configurações do 
projeto, abrir a aba Membros, clicar em Novo membro, selecionar 
o usuário desejado e clicar em Adicionar. 


Pesquisar por usuários ou grupos: 


+ Thomas 


Thomas Anderson 


(1-1/1) 
“ Papéis 


C] Gerente Desenvolvedor C] Informante 


Adicionar || Cancelar 


Figura 12.2: Selecione um ou mais usuários para adicionar ao projeto. 


Outra forma de adicionar um usuário a um projeto é editando o 
usuário. Ali será possível selecionar os projetos que o usuário 
participa. 


Um usuário pode participar de nenhum ou de vários projetos. E além 
disso, pode ter papéis diferentes em cada projeto. 


No próximo capítulo (Personalizando o Redmine) veremos como 
ajustar os papéis e permissões dos usuários para atender às 
necessidades dos seus projetos. 


12.3 Grupos de usuários 


Em casos onde a equipe é muito grande, torna-se útil a criação de 
grupos de usuários. Desta forma é possível atribuir uma tarefa a um 
grupo, assim como adicionar um grupo inteiro como membro de um 
projeto. 


Adicionando grupos 


Para criar um grupo de usuários, acesse a opção Administração no 
menu superior, clique em Grupos e então em Novo grupo. Na tela 
que se abrirá, basta informar o nome do grupo. 


Após adicionar o grupo, será possível adicionar usuários a este 
grupo, e também adicionar o grupo a projetos. 


Grupos » Desenvolvedores 


Usuários 


O Novo usuário 


Usuário 


Thomas Anderson Excluir 


Figura 12.3: Listagem de usuários de um grupo. 


Ao adicionar um grupo a um projeto, todos os membros recebem o 
mesmo papel do grupo. Além de poderem desempenhar papéis 
específicos além do papel atribuído ao grupo. 


12.4 Observadores 


Talvez você já tenha percebido em algumas telas uma estrela com a 
palavra Observar ao lado. Ao clicar neste link, você será 
comunicado via e-mail sobre as alterações realizadas neste item. 
Além disso, é possível adicionar outros observadores também. 


Esta funcionalidade é muito útil para especificar os envolvidos com a 
tarefa, para que estes sejam informados do andamento da tarefa. 


Além disso, permite que você receba notificações de tarefas 
específicas que você queira acompanhar, mesmo que não esteja 
mais atribuída a você. 


S r o fim] ) 
Jr Parar de observar Copiar Ww Excluir Tarefas 


Ver todas as tarefas 
« Anterior Resumo 
Calendário 
Gantt 
Importar 


16/04/2025 
Observadores (2) Adicionar 


100% Thomas Anderson 


30.00 h Gerente dos Projetos 


Adicionar 


Adicionar 


Figura 12.4: Lista de observadores no menu lateral. 


Ao observar algum item você será notificado por e-mail sobre 
qualquer modificação dependendo das configurações da sua conta. 


Conclusão 


Agora que já sabemos como adicionar itens e mais importante, 
adicionar usuários aos nossos projetos, o próximo capítulo explicará 
como personalizar o Redmine para que a sua equipe tenha a melhor 
experiência possível no dia a dia. 


CAPÍTULO 13 
Personalizando o Redmine 


Até então, utilizamos o Redmine com a configuração padrão de 
situações de tarefas, papéis, tipos e outras informações. Neste 
capítulo, veremos como realizar ajustes para deixar o Redmine 
personalizado de acordo com as necessidades da sua equipe. 


13.1 Papéis e permissões 


13.2 Papéis 


Ao adicionar um usuário ou grupo a um projeto, é necessário 
informar o papel que este terá. Ao menos um papel deve ser 
definido para cada usuário, pois é ele que determinará as 
permissões para cada um. 


Como vimos no capítulo anterior, é possível definir vários papéis 


para um usuário ou grupo. Agora veremos como personalizar estes 


papéis de acordo com a estrutura da sua equipe. 


No cenário da Mina Vermelha, poderíamos ter papéis como 
desenvolvedor, analista, testador, gerente do projeto etc. 


Adicionando um novo papel 


As configurações referentes aos papéis estão disponíveis no item 


Papéis e permissões no menu Administração. Através desta tela 


será possível editar os papéis já existentes e adicionar novos. 


Papéis » Novo papel Administração 

































































Nome * Adega 
& Usuários 
Tarefas podem ser [v 2 Grupos 
atribuídas a este papel P 
Visibilidade das tarefas Todas as tarefas não privadas v ka) Tipos de tarefas 
Visibilidade do log de | Todas as entradas de tempo v i Situagão dan tarolas 
tempo bg Fluxo de trabalho 
Visibilidade do usuário [Todos usuários ativos = ef etica corra 
-= Tipos & Categorias 
Copiar fluxo de trabalho v é Configurações 
de é Autenticação LDAP 


Figura 13.1: Tela de cadastro de novo papel. 


Ao realizar o cadastro de papéis, haverá os seguintes campos para 
serem preenchidos: 


Nome: nome descrevendo o papel. 

Tarefas podem ser atribuídas a este papel: permite a 
atribuição de tarefas aos usuários com este papel. 
Visibilidade das tarefas: define quais as tarefas que o usuário 
poderá visualizar. 

Visibilidade do log de tempo: define quais registros de tempo 
o usuário poderá visualizar. 

Visibilidade do usuário: define quais usuários o usuário 
poderá visualizar. 

Copiar fluxo de trabalho de: permite a cópia do fluxo de 
trabalho de outro papel criado anteriormente. 


Logo abaixo desses campos de cadastro, haverá uma relação de 
várias permissões específicas que o papel terá. Os campos são 
autoexplicativos, e permitem configurar as permissões que os 
usuários utilizando este papel terão. 


DICA: PAPÉIS 


Adapte os papéis de acordo com suas necessidades. Caso você 


utilize Scrum, é interessante criar papéis como Product Owner e 
Scrum Master, por exemplo, adicionando as permissões mais 
adequadas a cada um destes. 





13.3 Fluxo de trabalho 


Esta talvez seja uma das funcionalidades mais interessantes no 
Redmine: o fluxo de trabalho permite controlar as tarefas da criação 
até o fim. 


Para configurar os fluxos de trabalho, acesse Administração e 
Fluxo de trabalho. 


Através desta tela você poderá selecionar o papel do usuário e o 
tipo da tarefa. Vamos supor que você queira editar o fluxo de 
trabalho dos desenvolvedores, quando a tarefa for do tipo Defeito. 
Basta selecionar ambos e então você terá uma tela semelhante à 
imagem a seguir: 


Fluxo de trabalho Copiar 4 Resumo 


Estados das transições | Permissões de campos 


Selecione um papel e um tipo de tarefa para editar o fluxo de trabalho: 


Papel: | Desenvolvedor v | a Tipo de tarefa: | Defeito vim 


Somente exibir situações que são usadas por este tipo de tarefa 











ə Situação atual Nova situação permitida 
& Nova v Em vY d Y ” 
andamento Resolvida Feedback Fechada Rejeitada 















































4 Nova tarefa C g [] C] 
v Nova C 
ə Em andamento O [] 
& Resolvida E E 
4 Feedback O C] 
“ Fechada E g g O E 
“ Rejeitada O O O L O 














Transições adicionais permitidas quando o usuário é o autor 
Transições adicionais permitidas quando o usuário é o responsável pela tarefa 


Figura 13.2: Tela de edição do fluxo de trabalho. A primeira linha corresponde à tarefa que 
está em processo de criação e ainda não tem situação definida. 


A edição do fluxo de trabalho é muito simples. Basta informar quais 
são as situações permitidas de acordo com a situação atual da 
tarefa. Um exemplo de modificação interessante neste fluxo é não 
permitir que os desenvolvedores fechem uma tarefa que ainda não 
foi testada (feedback). Para isto, basta desmarcar os campos 
correspondentes na coluna Fechada. 


& Situação atual Nova situação permitida 



























































































































































* Nova En C pi v hd 
andamento Resolvida Feedback Fechada Rejeitada 

“ Nova tarefa C] C] 
“ Nova [v] v [v] E C] 
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“ Resolvida [v] [v [] 
* Feedback v] 
“ Fechada C] 
“ Rejeitada [] 















































Figura 13.3: Sugestão de alteração do fluxo de trabalho. 


Ainda na tela de edição do fluxo de trabalho, há também uma aba 
chamada Permissões de campos. Através desta aba é possível 
configurar para que, dependendo do papel do usuário, este não 
consiga alterar determinados campos. 


DICA: CONFIGURANDO O FLUXO DE TRABALHO 


Monte e adapte o seu fluxo de trabalho constantemente, 
principalmente se você utilizar alguma metodologia de 


desenvolvimento como o Scrum. Lembre-se! O fluxo de trabalho 
deve servir para auxiliar o trabalho de todos, mas também deve 
impedir que etapas importantes dos processos sejam 
negligenciadas, como a fase de testes, por exemplo. 





13.4 Situação das tarefas 


Até então, em nosso fluxo de trabalho utilizamos as situações das 
tarefas como vieram configuradas no Redmine. Mas podemos editá- 
las e adicionar novas situações. Para fazer isso acessamos o menu 
Administração e Situação das tarefas. 


A seguir, há um exemplo de alteração das situações para se 
adequar ao uso do Scrum. 











Situação das tarefas O Nova situação 
Situação Tarefa fechada 
Nova 4 fi Excluir 
Em desenvolvimento t fi Excluir 
Pronta para testes 4 Ti Excluir 
Em testes t @ Excluir 
Pronta V 4 m Excluir 
Rejeitada 2 t ii Excluir 


Figura 13.4: Sugestão de alteração das situações das tarefas. 


Uma configuração que em alguns casos pode ser interessante é 
alterar o Redmine para que o percentual de conclusão das tarefas 
obedeça às situações em que se encontram. 


Para isso, acesse o menu Administração, Configurações e 
acesse a aba Tarefas. 


Calcular o percentual de conclusão da | Use o campo da tarefa 


Use o campo da tarefa 






Usar a situação da tarefa 


Figura 13.5: Escolha a opção: Usar a situação da tarefa. 


É importante saber que, ao selecionar esta opção, não será possível 
informar um percentual manualmente. Todas as tarefas seguirão as 
configurações de percentual informadas nas situações. Ao acessar 
a tela para gerenciar as situações, será possível informar o 
percentual padrão delas. 


Situação das tarefas OQ Novasituação [5 Atualizar percentual de conclusão das tarefas 


Situação 9% Terminado Tarefa fechada 
Nova 0 t Excluir 
Em desenvolvimento 10 t Excluir 
Pronta para testes 40 t Excluir 
Em testes 60 t Excluir 
Pronta 100 Lá t Excluir 
Rejeitada 0 z7 t Excluir 








Figura 13.6: Exemplo de percentuais por situação. 


Utilizando a configuração apresentada na imagem anterior, ao 
alterar a situação de uma tarefa para Pronta para testes, 
automaticamente o percentual de conclusão da tarefa será alterado 
para 40%. 


Ao clicar em Atualizar percentual de conclusão das tarefas, o 
Redmine alterará todos os percentuais das tarefas, de acordo com 
as configurações das situações. Esta opção é útil após alterações 
de configurações de percentuais. 


13.5 Tipos de tarefas 


Como padrão, o Redmine oferece a criação de atividades do tipo 
Bug, Funcionalidade e Suporte. Mas, dependendo do cenário, estes 
tipos podem não atender totalmente às necessidades reais. 


Por isso, o Redmine permite o gerenciamento destes tipos, além de 
possibilitar que as tarefas sigam comportamentos diferenciados de 
acordo com o fluxo de trabalho definido para o seu tipo. 


Acesse Administração e Tipos de tarefas para alterar as situações 
padrões ou então adicionar novos tipos. 


Tipos de tarefas » Suporte 


“ Projetos 





Nome * [Suporte | 





[| Mina Vermelha App 





Situação padrão * | Nova v] 





Exibir no planejamento [| 


Atribuído para 
Categoria 
Versão 

Tarefa pai 

Início 

Data prevista 
Tempo estimado 
% Terminado 
Descrição 


campos padrão 














[9] [9 [9 [9 9 X] 9 9 K] 


Figura 13.7: Tela de alteração de tipos de tarefas. 


A adição dos tipos Análise, Defeito e Melhoria geralmente são 
tipos de tarefas úteis para a diferenciação das atividades possíveis. 


Através dos tipos das tarefas é possível configurar as situações 
padrões das tarefas, assim como os campos padrões que estarão 
disponíveis. 


13.6 Tipos e categorias 


Como nem todos os cenários são semelhantes, pode ser que surja a 
necessidade de ajustar alguns itens no Redmine. 


Digamos que você precise testar algo, ou então escrever uma 
documentação. Como você registraria o tempo gasto com estas 
duas atividades? Como Planejamento ou Desenvolvimento? 


Fica claro que apenas estes tipos de registos não servem para 
todos os cenários. 


Neste caso, é possível personalizar o Redmine através do menu 
Administração > Tipos e Categorias, onde podemos adicionar 
Categorias de documentos, Prioridade das tarefas, e as 
Atividades de registro de horas. 


Ao alterar os tipos e categorias é possível definir quais os padrões 
iniciais, qual a ordem de exibição, e quais as opções padrões. 


Como exemplo, podemos criar uma atividade de registro de horas 
chamada Testes e outra Documentação. Crie os tipos e categorias 
que você julgar necessários. 


Atividades (registro de horas) 


Q Novo 

Nome Situação padrão Ativo 
Planejamento Ed $ ii Excluir 
Desenvolvimento 7 2 $ ij Excluir 
Testes 2 t Excluir 
Documentação s $ T Excluir 


Figura 13.8: Exemplo de atividades para registro de horas. 


DICA: PRIORIDADE DAS TAREFAS 


Existem pessoas que gostam de cadastrar tarefas com 
prioridade alta, urgente, crítica entre outros com o único objetivo 
de ter sua solicitação atendida com maior antecedência, ou até 
mesmo por acomodação. 


Caso aconteça isso com frequência na sua equipe, pense em 
alterar as prioridades padrões para uma escala numérica como 
1-Baixa e 5-Alta, por exemplo. 


Outra sugestão é criar algumas prioridades específicas para 
casos como Perda de dados, Indisponibilidade, entre outros. 





13.7 Campos personalizados 


Esta funcionalidade é muito interessante no Redmine e garante uma 
grande flexibilidade. Digamos que você esteja utilizando o controle 
de versões do Redmine para a organização das tarefas nas Sprints 
e queira especificar a data de início dela. 


Basta adicionar um campo personalizado nas versões, e chamá-lo 
de Data de início. 


Campos personalizados » Versões » Novo campo personalizado 








Formato | Data v Obrigatório 























Nome * |Data de Início É um filtro [] 











Descrição |Data de início da 
versão 











Padrão |dd/mm/aaaa 














Valores do link para URL 








Salvar 











Figura 13.9: Adição de data de início nas versões. 


Através dos campos personalizados é possível adicionar campos 
aos seguintes itens: 


e Tarefas 

e Tempo gasto 

e Projetos 

e Versões 

e Documentos 

e Usuários 

e (Grupos 

e Atividades (registro de horas) 
e Prioridade das tarefas 

e Categorias de documento 


Desta forma você pode acrescentar campos específicos para 
auxiliar no seu dia a dia. Para adicionar campos personalizados, 
basta acessar Administração > Campos personalizados. Clique 
em Novo campo personalizado e selecione para qual item você 
deseja adicionar o novo campo. 


É possível criar campos de vários tipos de acordo com a sua 
necessidade. Um tipo de campo interessante é o campo do tipo 
Lista, onde é possível informar os valores possíveis de seleção. 


Campos personalizados » Tarefas » Novo campo personalizado 























Formato | Lista v Obrigatório [|] 

Nome * Sistema É um filtro [] 

Descrição Pesquisável [] 
Visível 


Múltiplos valores Ea 
O @ para qualquer usuário 





Possíveis valores |sistema A (O para os papéis: 
Sistema B Gerente 
Sistema C Desenvolvedor 
Sistema X 
E Informante 
Sistema Y 
Sistema Z 





“ Tipos de tarefas 
C] Defeito [ ] Funcionalidade [ ] Suporte 


Uma linha para cada valo 


Padrão |Sistema A 



































Valores do link para URL 2 Projetos 
Exibição | lista suspensa y | Para todos os projetos [ ] 
[C] Mina Vermelha App 


Figura 13.10: Adição de campo do tipo lista. 
Conclusão 


Agora que vimos como personalizar o Redmine, no próximo capítulo 
vamos focar na análise dos dados armazenados nele, de forma que 
facilite o gerenciamento dos nossos projetos e das nossas Sprints. 


CAPÍTULO 14 
Analisando os dados 


A utilidade de um sistema está muitas vezes relacionada à 
quantidade e qualidade de resultados gerados através dos dados 
cadastrados. De nada adianta cadastrar uma infinidade de dados, 
se você não pode trabalhar com eles depois. Por isso, o foco deste 
capítulo é justamente apresentar as formas de analisar os dados 
cadastrados no Redmine para um maior controle e produtividade 
dos projetos gerenciados através dele. 


14.1 Consultas personalizadas 


Como vimos no capítulo anterior, é possível personalizar o Redmine 
para que você consiga trabalhar da melhor maneira com as 
metodologias de desenvolvimento existentes. Agora surge a 
necessidade de consultar os dados para medir os resultados. 


Digamos que você precise analisar o desempenho da sua equipe 
nas Sprints, ou identificar as tarefas prioritárias no Backlog (lista de 
tarefas que estão aguardando para entrar em uma Sprint). 


Para ter acesso a estas informações, o Redmine permite a criação 
de consultas personalizadas para facilitar o trabalho de analisar os 
dados nele cadastrados. 


Criando consultas personalizadas 


Para criar uma consulta personalizada, basta acessar a aba Tarefas 
do projeto, definir um filtro de acordo com suas necessidades e 
então clicar em Salvar. 


Nova consulta 





Nome |Backlog 











Visível (O) para mim 
@) para qualquer usuário 
(O para os papéis: 





































































































Gestor 
Programador 
Repórter 
Para todos os projetos [| 
Opções 
Colunas padrão |v 
Agrupar por v 
Exibir Descrição Últimas notas 
Totais Tempo estimado [ ] Tempo gasto 
Filtros 
7] Versão [iguala »] [Mina Vermelha App - Backlog v| a Adicionar filtro | v 
Ordenar 
1:|# v || Descendente v 


Figura 14.1: Criação de uma consulta listando as tarefas do Backlog. 


Como pode ser visto na imagem anterior, criamos uma consulta 
listando as tarefas da versão Backlog. Desta forma podemos 
facilmente identificar as tarefas que estão aguardando para fazer 
parte de alguma Sprint. 


Ao criar uma consulta personalizada, é muito importante observar as 
opções de visibilidade, marcando as opções para qualquer usuário 
e para todos os projetos quando for conveniente. No bloco 
Opções, é possível personalizar a forma de exibição das tarefas, 
definindo agrupamento, totalizadores e outros ajustes. 


Todas as consultas personalizadas visíveis ao usuário ficam 
disponíveis no menu lateral na tela de tarefas, como pode ser visto 
na imagem a seguir. 


Sprint 01 O Novatarefa Tarefas 


Filtros Ver todas as tarefas 
Resumo 

Calendário 

Gantt 

Importar 


Opções 


* Aplicar Q Limpar 2 Editar Excluir 


Título Situação % Terminado Consultas personalizadas 





Realizar o Levantamento dos Requisitos Em desenvolvimento Backlog 





Entrevistar o Cliente Fulado Pronta 





w nm E 











Entrevistar o Cliente Sicrano Nova 





Figura 14.2: Exemplo de consulta personalizada com apenas algumas colunas. 


Crie quantas consultas desejar para facilitar o seu trabalho e de sua 
equipe. 


14.2 Relatório de tempo gasto 


Um dos grandes problemas no gerenciamento de projetos é manter 
um controle do tempo eficiente, de maneira que as entregas do 
projeto sejam realizadas nos prazos determinados. 


Por isso, o tempo gasto nas atividades deve ser muito bem 
gerenciado, uma vez que é um dos recursos mais importantes no 
seu projeto, e que deve servir de base para a estimativa de tempo 
de novas tarefas e prazos. 


Em todos os projetos onde o módulo de gerenciamento de tempo 
estiver habilitado, haverá a informação de quanto tempo foi gasto no 
projeto na aba Visão geral. 


Mais detalhes a respeito do tempo gasto é possível acompanhar 
através dos links Detalhes e Relatório. 


Tempo gasto 
> Filtros 


b Opções 
* Aplicar QB Limpar 


Detalhes Relatório 





Horas: 5.00 
[] Data Usuário Tarefa Horas 
[] 01/04/2025 Gerente dos Projetos Suporte #1: Levantamento dos Requisitos 3.00 4/ m- 
C] 25/06/2025 Gerente dos Projetos Superte-*2: Entrevistar o Cliente Fulado 2.00 2 Ñ- 








Figura 14.3: Aba Detalhes: utilize os filtros para descobrir detalhes sobre o tempo investido 
no projeto. 


Na aba Relatório você poderá adicionar até 3 agrupadores para 
consultar o tempo gasto, além da possibilidade de também utilizar 
filtros. 


Detalhes | Relatório 





Detalhes: | Mês 


< 


Adicionar: 2 Limpar 











Total: 15.00 horas 


Versão Tipo de tarefa Tarefa 2025-4 2025-5 2025-6 Total 
Sprint 01 
Suporte 
Suporte #1: Levantamento dos Requisitos 3.00 3.00 
Suporte #2: Entrevistar o Cliente Fulado 2.00 2.00 
Suporte #3: Entrevistar o Cliente Sicrano 10.00 10.00 
Total 3.00 10.00 2.00 15.00 


Figura 14.4: Aba Relatório: agrupamento por Versão, Tipo de tarefa e Tarefa. 
Conclusão 


Com todas estas opções de análise de dados, é possível observar 
onde o tempo está sendo empenhado. Ao comparar os tempos 
previstos com os tempos realizados, conseguimos refinar as 
estimativas e também melhorar o desempenho da nossa equipe. 


No próximo capítulo veremos algumas situações especiais que 
podem surgir durante o gerenciamento de projetos, e como lidar 
com estas situações no Redmine. 


CAPÍTULO 15 
Situações especiais 


Nenhuma equipe ou pessoa trabalha igual a outra. Sempre existem 
algumas diferenças. E já dizia o Sr. Henry Ford: 


Se duas pessoas pensam sempre exatamente iguais em um time, 
uma delas é desnecessária. 


Desta forma, com várias pessoas pensando diferente em um time, a 
flexibilidade de um sistema é a chave para o seu sucesso e, neste 
ponto, o Redmine com seus campos personalizados, suas consultas 
personalizadas e suas diversas configurações conseguiu agradar a 
um grande público. 


Mas, mesmo assim, existem situações especiais que necessitam de 
atenção por parte do gerente de projetos para conseguir trabalhar 
de forma eficiente. 


15.1 Desenvolvimento pareado 


Uma prática do desenvolvimento ágil muito comum e vantajosa na 
maioria das vezes é o desenvolvimento pareado, que nada mais é 
do que o desenvolvimento de uma tarefa por duas pessoas. 


No passado, já houve discussões a respeito de adicionar uma 
funcionalidade exclusiva para registrar o desenvolvimento pareado 
no Redmine, porém, tais discussões até então não chegaram a 
produzir algo específico. Hoje já existem diversas maneiras de se 
fazer isso. 


A seguir, estão algumas das formas de registro, mas é importante 
observar que não há uma forma ideal. Você precisa identificar qual a 


maneira que melhor auxilia no desenvolvimento do seu projeto. 
Subtarefas 


Uma maneira de registrar o desenvolvimento pareado é através da 
criação de subtarefas. Digamos que exista uma tarefa cujo objetivo 
seja desenvolver e documentar uma rotina de cadastro de usuários. 
Poderia ser criada uma subtarefa para que outro usuário realize a 
documentação da rotina de cadastro, em paralelo ao seu 
desenvolvimento. 


Um outro exemplo que é interessante é a divisão de tarefas em uma 
história de Sprint. Em alguns casos, uma história de Sprint pode ter 
várias subtarefas, neste caso permitindo que elas sejam atribuídas a 
usuários distintos. Assim, a utilização de subtarefas também permite 
a divisão de responsabilidades. 


Campo personalizado 


Outra forma de trabalhar com desenvolvimento pareado é criar um 
campo personalizado para informar qual o usuário que está 
trabalhando em conjunto. É importante que cada usuário informe o 
seu tempo de trabalho correspondente, detalhando a sua 
participação no desenvolvimento. 


Para adotar esta estratégia, basta criar um campo personalizado 
para as tarefas e selecionar Usuário como formato. 


Campos personalizados » Tarefas 


Formato 
Nome * Colaborador(es) 


Descrição |Colaboradores da 
Tarefa 





Múltiplos valores 


Papel @ todos 
O) somente: 
Gerente 
Desenvolvedor 
Informante 


Exibição | lista suspensa ~ 





Figura 15.1: Ao marcar a opção Múltiplos valores, será possível relacionar vários usuários 
à tarefa. 


Então, será possível relacionar mais usuários que auxiliarem no 
processo de desenvolvimento da atividade. 


Grupos de usuários 


Como vimos no capítulo Usuários, podemos criar grupos de 
usuários. Desta forma podemos atribuir um grupo de usuários a uma 
tarefa. Esta é a maneira que se pode considerar menos aplicável, 


pois na maioria das vezes, em uma equipe dinâmica, os 
desenvolvedores dificilmente formarão os mesmos pares, tornando 
inviável o gerenciamento das possíveis combinações de duplas, e 
atrasando o trabalho de gerenciamento do administrador por ter que 
criar grupos constantemente. 


Registro em comentários 


Uma das maneiras mais simples talvez seja apenas registrar em 
notas os momentos em que houve participação de mais de um 
usuário no desenvolvimento das tarefas. Esta forma mostra-se ágil, 
pois permite grande flexibilidade e facilidade por parte dos usuários 
para registrar as informações. 


Porém, pode prejudicar a rastreabilidade, pois um usuário pode 
participar do desenvolvimento de uma tarefa e não receber 
notificações em caso de alterações, por não ser responsável 
diretamente por ela. 


Por isso, é extremamente importante que os usuários registrem os 
seus tempos de trabalho e marquem para observar as atividades em 
que estiverem envolvidos no desenvolvimento pareado. 


15.2 Tarefas não previstas 


Nem sempre podemos trabalhar apenas com o que planejamos. 
Tarefas não previstas podem surgir em qualquer projeto, pois, na 
maioria dos casos, as demandas surgem de outros lugares, sejam 
de clientes, diretorias ou até mesmo da famosa Lei de Murphy, 
quando podem ocorrer perda de dados, falhas de segurança e 
outras requisições urgentes. Isso faz parte do dia a dia da maioria 
das equipes. 


Nesses casos, existem as chamadas tarefas não previstas, que, 
devido à sua urgência, precisam ser desenvolvidas durante a Sprint 


em execução, e não podem esperar. Para essas situações, pode-se 
criar uma tarefa adicional (caso não exista ainda), e acrescentá-la à 
versão. Na maioria das vezes, por não ser prevista, não terá um 
tempo estimado, e comprometerá em partes o planejamento 
executado anteriormente. De qualquer forma, é importante o registro 
destas atividades, assim como o tempo empenhado nelas. 


É claro que pode haver exceções, como as atividades urgentes que 
podem exigir menos tempo de desenvolvimento do que o tempo 
para se criar a tarefa no Redmine, por exemplo. Nestes casos, a 
equipe deve julgar se é de fato necessária a criação da tarefa. 


15.3 Copiando projetos 


Em determinadas situações, sua equipe pode trabalhar com projetos 
semelhantes no dia a dia, fazendo com que seja gasto mais tempo 
cadastrando do que de fato gerenciando estes projetos. Isso é muito 
comum no caso de agências de desenvolvimento web, onde podem 
existir vários projetos de desenvolvimento de sites em execução 
paralela, por exemplo. 


Para poupar tempo, existe a possibilidade de copiar projetos. Neste 
caso, é recomendada a criação de um projeto para servir como 
base, apenas com os itens comuns a todos os projetos. Desta 
forma, ao criar um novo projeto, basta copiar o projeto base através 
do menu Administração > Projetos. 


Projetos ð Novo projeto 








Filtros 
Situação : Projeto: | || Aplicar | ® Limpar 
Projeto Público Criado em 
Meu Primeiro Projeto 2 31/12/2055 É Arquivar Copiar fi Excluir 
PROJETO BASE LÁ 01/01/2056 (=) Arquivar ES tj Excluir 


Figura 15.2: A criação de um projeto modelo pode auxiliar no processo de criação de novos 
projetos. 


Como pode ser visto na imagem, é possível também arquivar 
projetos antigos, no caso de existirem muitos projetos no Redmine. 
Ao arquivar um projeto, ele ficará oculto aos usuários, porém o 
administrador poderá ainda copiar o projeto ou restaurá-lo. 


15.4 Copiando tarefas 


Assim como os projetos, as tarefas também permitem a criação de 
cópias para poupar tempo. 


Suporte #1 4 Editar QÀ Tempo de trabalho r Parar de observar Copiar fij Excluir 


Figura 15.3: Ao copiar uma tarefa, será possível determinar em qual projeto a nova tarefa 
será adicionada. 


Basta clicar em Copiar e alterar as informações da tarefa de acordo 
com as necessidades. 


15.5 Edição em lote 


Existem casos onde é necessário realizar ajustes em uma série de 
tarefas, como mover todas as tarefas não desenvolvidas em uma 
Sprint para a Sprint seguinte, por exemplo. Neste caso, aí vai uma 
dica útil! 


É possível selecionar várias tarefas e realizar edições em lote, 
clicando com o botão direito do mouse. 


# Título Situação % Terminado 





Levantamento dos Requisitos 4 Editar 


Situação 


1 
2 Entrevistar o Cliente Fulado 
3 Entrevistar o Cliente Sicrano Tipo 


E 





Priondade b 





| Versão » Backlog 











Atribuído para > Sprint 01 pm | CSV | PDF 
Observadores > | Sprint 02 | 

Ýr Parar de observar nenhum dim 

:= Filtro 


Copiar 


Excluir 


El 


Figura 15.4: Exemplo do edição em lote. 


É claro que no cotidiano podem surgir outras situações especiais, e 
em cada uma delas você encontrará as melhores maneiras de 
adaptar o Redmine ao seu projeto, ou talvez se inspire no Redmine 
para adaptar o seu modo de trabalho a ele. Caso encontre alguma 
situação específica que você não consiga identificar uma forma 
adequada de solucionar, entre em contato através dos links 
fornecidos na introdução deste livro. 


Conclusão 


Com este capítulo, encerramos a segunda parte deste livro. Você 
pode realizar mais um exercício para fixar o que aprendeu, 
utilizando o QR Code a seguir com o seu celular, ou acessando o 
seguinte endereço: http://bit.ly/redlab3/ 






Tir go m” 
Ta 





Figura 15.5: http://bit.ly/redlab3. 


Até então vimos como utilizar o Redmine e gerenciar projetos com 
ele. Já nos próximos capítulos vamos nos aprofundar na 
administração da aplicação, para garantir o seu funcionamento 
constante. 


Parte C: Administrando o 
Redmine 


CAPÍTULO 16 
Mantendo o Redmine seguro 


Imagine que o seu time já está acostumado a utilizar o Redmine, 
todas as engrenagens estão alinhadas e sua equipe está 
sincronizada, seguindo a metodologia ideal para a produtividade dos 
seus projetos. Então algo ocorre: o servidor onde o Redmine estava 
instalado parou de funcionar por causa de um problema de 
hardware, e todo o Redmine foi perdido, deixando sua equipe sem 
saber o que fazer. 


Este seria um dos piores cenários possíveis, mas existem muitos 
outros. Por isso, a partir de agora vamos focar na administração do 
Redmine, analisando aspectos técnicos da sua estrutura, para 
mantê-lo funcionando e também para realizar melhorias, como 
instalar e criar temas e plugins, realizar atualizações de versões, 
entre outras utilidades. 


16.1 Protegendo o banco de dados 


Como a base de dados é um dos itens essenciais para o 
funcionamento do sistema, é importante que ela esteja sempre 
disponível e segura contra acessos não autorizados. Por isso temos 
que adotar algumas estratégias de proteção. 


Uma das possíveis melhorias de segurança é controlar o acesso à 
porta padrão de acesso ao servidor de banco de dados. Cada 
sistema de banco de dados utiliza uma porta padrão de acesso. O 


ideal é que o acesso a essas portas esteja disponível apenas ao 
servidor do Redmine, para que não seja possível acessá-lo 
remotamente através da internet. 


O acesso direto ao banco de dados pode ser necessário para 
gerenciamento por parte de uma pessoa responsável pela 
administração da base de dados (DBA - database administrator), ou 
no caso de integrações com outros sistemas, como impressões de 
relatórios através de ferramentas externas, ou exportação de dados 
para sistemas de Business Intelligence. Vamos explorar situações 
específicas de integrações no capítulo Integrando o Redmine a 
outros serviços. Nesses casos, é recomendada a criação de regras 
exclusivas, limitando o acesso a um determinado endereço IP, ou 
então a uma rede local. É interessante também realizar a alteração 
do número da porta de acesso padrão para outra alternativa, para 
amenizar as tentativas de acesso de potenciais atacantes. 


É importante observar que, para acessar o Redmine através da 
internet, não é necessário que o acesso direto ao banco de dados 
também esteja acessível. O Redmine interage com o banco de 
dados na rede local, sem que o usuário precise de acesso direto à 
base de dados. 


Protegendo o MySQL 


A partir de agora, vamos analisar na prática como realizar estes 
ajustes de segurança. Para isso, vamos utilizar como exemplo o 
banco de dados MySQL, porém, as mesmas configurações 
apresentadas a seguir são válidas para outros sistemas de banco de 
dados, mudando apenas os comandos e formas como devem ser 
executadas. 


Para proteger o MySQL, é necessário inicialmente verificar o arquivo 
de configuração my.ini (no Windows) ou my.cnf (para os demais 
sistemas). 


Geralmente este arquivo estará na pasta de instalação do MySQL, 
mas não obrigatoriamente. Caso não seja o caso, você poderá 
utilizar o seguinte comando: 


mysqladmin --help 


Este comando retornará várias informações, e uma delas será o 
caminho do arquivo de configuração do MySQL. 


Liberando o acesso externo 


Ao abrir o arquivo de configurações, você encontrará um bloco 
[mysqld], em que haverá a seguinte linha: 


bind-address=127.0.0.1 


Caso esta linha não esteja comentada (linhas comentadas possuem 
o símbolo # no início), o acesso ao MySQL estará disponível 
apenas para acessos através do mesmo servidor. 


Caso queira liberar o acesso através da internet, será necessário 
comentar esta linha e reiniciar o MySQL. 


Ebind-address=127.0.0.1 
Alterando a porta de acesso 


Neste mesmo arquivo, haverá a configuração port que serve para 
definir qual a porta utilizada pelo banco de dados. Para trocar a 
porta utilizada pelo MySQL, é necessário alterar a configuração 
port NOS blocos mysqladmin , mysqld e mysql. 


No exemplo a seguir, estamos fazendo com que o MySQL passe a 
utilizar a porta 3333. 


[mysqladmin] 
port=3333 


[mysqld] 
port=3333 


[mysql] 
port=3333 


Além disso, é necessário informar ao Redmine a nova porta de 
acesso ao banco de dados. Esta configuração está localizada no 
arquivo database.yml , que também possui a configuração port, 
como vimos no capítulo Instalando o Redmine manualmente. 


production: 
adapter: mysql2 
database: redmine 
host: 127.0.0.1 
username: reduser 
password: senhadificil 
port: 3333 


Após alterar a porta nos arquivos de configuração, basta reiniciar o 
MySQL e o Redmine, para que o banco fique disponível através de 
outra porta de acesso, dificultando possíveis tentativas de ataque 
através da porta padrão do MySQL. 


Para outros sistemas de banco de dados, o processo é semelhante, 
basta alterar a configuração de porta do sistema, e a configuração 
do Redmine. 


Permitindo o acesso do usuário através de outras redes 


Para que o usuário consiga realizar o acesso ao servidor 
remotamente, é necessário que ele tenha permissões para fazer 
isso. Por isso, o administrador do banco de dados deve executar um 
comando semelhante a este: 


GRANT ALL PRIVILEGES ON BANCO.* TO "USUARIO '(0'%' 
IDENTIFIED BY 'senha'; 


Caso queira que o usuário realize o acesso apenas através do IP 
127.0.0.1 , O comando a ser executado deve ser o seguinte: 


GRANT ALL PRIVILEGES ON BANCO.* TO 'USUARIO'Q'127.0.0.1' 
IDENTIFIED BY 'senha'; 


Para outros endereços IPs, basta alterar o IP 127.0.0.1 para o 
correspondente ao endereço de origem do acesso. Desta forma, 
possíveis atacantes não terão acesso, pois estarão acessando 
através de outro endereço IP. 


16.2 Firewall 


Firewall é um dispositivo de uma rede de que tem por objetivo 
aplicar uma política de segurança a um determinado ponto da rede, 
servindo como uma camada de proteção. Por este motivo, é 
importante alinhar esta política de segurança com as necessidades 
de acesso do Redmine e à sua estrutura. 


Como existem vários tipos de firewall, vamos utilizar como exemplo 
apenas o firewall iptables, por ser um dos mais utilizados 
atualmente, e pelo fato de que outros sistemas de firewall funcionam 
de forma semelhante. 


Nos exemplos anteriores, realizamos a alteração da porta padrão do 
MySQL para a porta 3333. Por isso, caso algum usuário ou 
aplicação precise acessar remotamente, precisamos liberar o 
acesso externo à porta 3333 utilizando o protocolo TCP. Para isso, 
basta adicionar a seguinte regra ao nosso firewall: 


iptables -A INPUT -p tcp --dport 3333 -j ACCEPT 


Desta forma, O iptables passará a aceitar as conexões TCP cujo 
destino for a porta 3333, que é a porta em que o nosso sistema de 
banco de dados está aguardando que haja conexões, após as 
alterações no arquivo de configuração. 


Além de permitir o acesso através das portas necessárias, é 
interessante que sejam criadas regras para mitigar possíveis 
ataques DDOS e Brute Force. 


Dependendo do seu sistema de firewall, pode ser que estes 
bloqueios já estejam ativos. 


16.3 Análise de logs 


Para garantir a integridade e solucionar possíveis problemas de 
qualquer sistema, é interessante saber localizar e gerenciar logs das 
aplicações. No caso do Redmine, não é diferente. 


Na pasta raiz do Redmine, há um diretório chamado 1log , onde são 
armazenados os arquivos de log do sistema. Neste diretório, você 
encontrará o arquivo de log production.log correspondente ao 
ambiente de produção. 


Em caso de problemas com o Redmine, é importante analisar os 
arquivos de log, pois através deles é possível encontrar as causas. 
Como no exemplo a seguir: 


Mysql2::Error (Can't connect to MySQL server on 'localhost' (10061)): 
Significa que o Redmine não conseguiu realizar a conexão ao banco 


de dados MySQL, indicando que ele está parado e precisa ser 
iniciado para que o Redmine volte a funcionar. 


16.4 Backups: como criar uma cópia de 
segurança 


Para realizar backups do Redmine, seja por questões de segurança, 
ou para tarefas de atualização ou migração para outras estruturas, é 
necessária a cópia de dois itens: o banco de dados e os anexos. 


O ideal é que estas rotinas de backup sejam executadas uma vez 
ao dia pelo menos. Mas dependendo da estratégia de backups da 


sua empresa, podem existir rotinas de cópia da estrutura de disco 
rígido do servidor ou servidores. Neste caso tornando desnecessário 
o backup apenas do Redmine. 


Copiando o banco de dados 


Um dos itens mais importantes no momento de realizar backups do 
Redmine é a estrutura do banco de dados. Para isso, é necessário 
exportar o banco de dados em um momento em que o Redmine não 
esteja em execução. 


No caso do MySQL, é possível utilizar o comando mysqldump da 
seguinte maneira: 


mysqldump -u USUARIO -pSENHA -h SERVIDOR BASE-DE-DADOS > backup.sql 
Exemplo: 


mysqldump -u reduser -psenhadificil -h 127.0.0.1 redmine > backup.sql 


Desta forma, será criado um arquivo chamado backup.sql contendo 
a cópia da estrutura e dos dados do banco de dados do Redmine. 


Uma outra forma de realizar o backup da base de dados, é através 
de ferramentas de administração como o MySQL Workbench. 


Instalando o MySQL Workbench 


Para instalar o MySQL Workbench, faça o download dele através do 
site oficial: 


https://dev.mysql.com/downloads/workbench/ 


Ele possui uma interface muito intuitiva. Basta clicar em next 3 
Vezes, Install € Finish na versão para Windows. Para as demais 
plataformas, é possível baixar o pacote de instalação manualmente 
ou através de repositórios utilizando comandos como O apt-get no 
caso do Ubuntu, por exemplo: 


apt-get install mysql-workbench 


Adicionando a conexão ao banco de dados 


Após instalaro MySQL Workbench, é necessário adicionar as 
informações para que ele consiga se conectar a base de dados do 
Redmine. 


Ao iniciar o MySQL Workbench, você verá um bloco chamado mysqL 
Connections , seguido de dois botões. Clique sobre o primeiro para 
adicionar uma nova conexão. 
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Welcome to MySQL Workbench 


MySQL Workbench is the official graphical user interface (GUI) tool for MySQL. It allows you to design, 





create and browse your database schemas, work with database objects and insert data as well as 
design and run SQL queries to work with stored data. You can also migrate schemas and data from other 


database vendors to your MySQL database. 






ation > Read the Blog > Discuss on the Forums > 
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Local instance redmineMySQL Local instance redmineMySQ... 
root root 
localhost:3306 localhost:3307 


Figura 16.1: Tela inicial do MySQL Workbench. 


Como padrão, ele carregará as configurações padrões do MySQL 
em caso de instalações locais. Altere os dados de acesso ao banco 
de dados de acordo com o seu cenário, informando o endereço IP 
do servidor MySQL, além de mudar a porta de acesso ao MySQL, 
caso tenha alterado a porta padrão do MySQL. 
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Figura 16.2: Adicionando os dados de conexão ao banco de dados. 


Informe também os dados de usuário e senha para acessar a base 
dedos. 


Após confirmar, a nova conexão ficará disponível na tela inicial do 
MySQL Workbench. Basta clicar sobre ela para poder gerenciá-la. 


MySQL Connections O O 


Local instance redmineMySQL Local instance redmineMySQ... Redmine 
} root root reduser 
localhost:3306 localhost:3307 127.0.0.1:3333 


Figura 16.3: Adicionando os dados de conexão ao banco de dados. 


Ao acessá-la, haverá um menu lateral com várias opções de 
gerenciamento, que permitem o acompanhamento em tempo real do 
servidor de banco de dados. Uma das opções é a Data Export , que 
serve basicamente para realizar a exportação de dados. 
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Figura 16.4: Selecione a opção Data Export para realizar o backup da base de dados. 


Marque a base de dados do Redmine e escolha o local onde deseja 
que o backup seja gravado, semelhante à imagem a seguir: 
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All selected database objects will be exported into a single, self-contained file, 
C] Create Dump in a Single Transaction (self-contained file only) Indude Create Schema 


Press [Start Export] to start... Start Export 


Figura 16.5: Escolha salvar em um único arquivo ou em um diretório através da seção 
Export Options. 


Após selecionar a base de dados e o local desejado para gravar, 
clique em start Export , desta forma, o MySQL Workbench realizará 
o backup do banco de dados da mesma forma que o comando 
mysqldump , porém, permitindo que você defina os parâmetros 
visualmente. 


LEMBRETE IMPORTANTE 


No momento de realizar o backup, é importante que não existam 


usuários utilizando o Redmine, principalmente em momentos de 
atualização ou migração de estruturas, para evitar que ocorra a 
perda de informações. 





Restauração 


Mais importante do que a realização de backups, é saber como 
utilizá-los em caso de necessidades. No caso do MySQL, para 
realizar a restauração de uma base de dados através de um arquivo 
de backup, basta executar o seguinte comando: 


mysql -u USUARIO -pSENHA NOVA-BASE < backup.sql 


Executando o comando anterior, a estrutura e dados existentes no 
arquivo de backup serão restaurados em uma nova base de dados. 
Isso é útil no caso de migrações para outras estruturas, ou no caso 
de atualizações, que será o foco do nosso próximo capítulo. 


Este mesmo processo de restauração pode ser realizado utilizando 
o MySQL Workbench através do menu Data Import/Restore . 
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Press [Start Import] to start... 


Figura 16.6: Escolha um único arquivo ou um diretório através da seção Import Options. 


Basta selecionar o arquivo de backup, e clicar em start Import. 
Replicação utilizando log binário 


Outra opção interessante no caso do MySQL é a replicação 
utilizando log binário. Esta é uma funcionalidade nativa do MySQL 
que permite que as alterações na base de dados sejam replicadas 
para outro servidor, fazendo com que exista uma cópia idêntica dos 
dados instantaneamente. 


Desta forma, caso seja realizada alguma alteração no Redmine, 
esta alteração será replicada para uma outra base de dados 
idêntica. 


A replicação utilizando log binário requer uma série de 
configurações. Para isso, você precisará de dois servidores MySQL, 
além de editar os arquivos de configuração my.ini (OU my.cnf 
dependendo do sistema operacional) de ambos os servidores. 


Configurando o servidor principal 


Para ativar o log binário no servidor do Redmine, adicione ao 
arquivo de configuração do MySQL, as seguintes linhas (caso não 
existam): 


log-bin = mysql-bin 
server-id = 1 
binlog do db = redmine 


A configuração binlog do db Serve para informar qual base de dados 
deve ser replicada. Caso seja necessário replicar outras bases de 
dados, é possível repetir a configuração binlog do db outras vezes. 


Reinicie o MySQL para que as alterações tenham efeito. 
Configurando um usuário para realizar a replicação 


Precisamos de um usuário com permissões para realizar a 
replicação dos dados no servidor principal. 


Para adicionar estas permissões para o usuário reduser (ou outro 
usuário), podemos utilizar o seguinte comando SQL: 


GRANT REPLICATION SLAVE ON *.* TO 'reduser'0'%'; 
Configurações no servidor replicado (slave) 


Já em um segundo servidor contendo também uma instalação do 
MySQL, configure um ID para o servidor através do arquivo de 
configurações, da mesma forma que foi informado o ID 1 no servidor 
principal: 


server-id = 2 


É importante que o ID do servidor secundário seja diferente do 
servidor principal. Neste servidor secundário, não precisamos 
adicionar a linha para habilitar o log binário, mas precisamos 
reiniciá-lo também. 


Outro passo importante, é restaurar um backup do servidor principal, 
na estrutura do servidor secundário. Desta forma, ambos os 
servidores terão os mesmos dados. Assim que for executada 
alguma alteração nos dados ou estrutura do servidor principal, o 
mesmo comando será executado também no servidor secundário. 
Por isso, caso haja divergências nos registros, a replicação pode 
parar caso não consiga inserir, atualizar ou excluir algum registro. 


Após deixar os dados de ambos os servidores iguais, e realizar as 
alterações nas configurações, só precisamos informar ao servidor 
secundário de qual servidor ele deve buscar as informações de 
replicação e a partir de qual parte do log deve ser sincronizada. 


Para isso, precisamos buscar as informações do servidor principal, 
executando o seguinte SQL: 


SHOW MASTER STATUS; 


Que retornará algo assim: 


| File | Position | Binlog Do DB | Binlog Ignore DB | 
+------------------ +---------- +-------------- +------------------ + 
| mysql-bin.000001 | 111 | redmine | | 
+------------------ +---------- +-------------- +------------------ + 
1 row in set (0.00 sec) 


Dessa forma, temos os dados necessários para ativar a replicação 
no servidor secundário. Digamos que o servidor principal esteja na 
mesma rede do servidor secundário, e seu endereço IP seja 
192.168.0.123 . 


Então basta executarmos o seguinte comando SQL no servidor 
secundário para ativar a replicação: 


CHANGE MASTER TO 
MASTER_HOST='192.168.0.123', 
MASTER_USER='reduser', 
MASTER_PASSWORD='senhadificil', 
MASTER LOG FILE='mysql-bin.000001', 
MASTER LOG POS=111; 


Caso queira realizar configurações mais avançadas de replicação, 
como a utilização de mais de um servidor slave, é interessante ler a 
documentação oficial para configurar a replicação de acordo com as 
necessidades da sua empresa: 


https://dev.mysqgl.com/doc/refman/5.7/en/replication-howto.html/ 
Copiando os anexos 


Independente da realização de backups da base de dados, os 
anexos, documentos e imagens ficam separados em um diretório 
chamado files localizado na pasta raiz do Redmine. 


Por este fato é importante também a realização do backup destes 
arquivos em paralelo ao backup do banco de dados. 


Automatizando o processo de backup 


Para facilitar o processo de gerenciamento de backups, é possível 
criar scripts para automatizá-lo permitindo que sejam executados 
periodicamente pelo sistema operacional: 


No caso de sistemas Windows, é possível criar um arquivo com a 
extensão .bat com o seguinte conteúdo: 


mysqldump -u USUARIO -pSENHA BASE-DE-DADOS > C:NBackupsibackup.sqgl 
xcopy /s C:\Redmine\files C:\Backups\files 


Já para outros sistemas, é possível criar um shell script contendo 
os comandos gzip € rsync como no exemplo a seguir: 


Shell Script: 


#!/bin/bash 
mysqldump -u USUARIO -pSENHA BASE-DE-DADOS | gzip > /backups/db/redmine.gz 
rsync -a /opt/redmine/files /backups/files 


É importante ajustar o script de acordo com a localização da 
instalação do Redmine, e do diretório para armazenamento de 
backups. 


Conclusão 


Independente do sistema que você utilize, é importante pensar nas 
possíveis maneiras como atacantes podem tentar roubar dados, 
enganar usuários ou deixar seu sistema indisponível. Por isso, 
cuidados com backups, monitoramento de logs e gerenciamento de 
usuários são muito indispensáveis para garantir o bom 
funcionamento do Redmine. 


E, lembre-se, de nada adianta garantir a segurança do banco de 
dados, a configuração do firewall, as rotinas de backup, se você 
possui o usuário admin com uma senha fraca. 


No próximo capítulo, veremos como utilizar os arquivos de backup 
para realizar a atualização da versão do Redmine. 


CAPÍTULO 17 
Mantendo tudo atualizado 


Assim como qualquer software em processo de evolução, o 
Redmine conta com atualizações constantes, com foco na correção 
de problemas e na adição de novas funcionalidades. Por isso, é 
interessante saber como realizar a atualização de um Redmine 
utilizado em ambiente de produção quando for necessário. 


17.1 Quando atualizar? 


Esta é uma pergunta que você deve fazer para todos os sistemas 
que você utiliza. Em alguns casos, uma atualização de sistema pode 
alterar o modo como os usuários utilizam o sistema, causando 
desconforto inicial, mas ao mesmo tempo pode corrigir falhas de 
segurança que existiam na versão anterior. 


Então é necessário avaliar se é realmente necessário realizar a 
atualização proposta, ou aguardar o lançamento de uma próxima 
versão. 


Antes de atualizar para uma nova versão do Redmine (assim como 
de qualquer outro software), é interessante verificar a relação de 
alterações que a nova versão está trazendo. 


No caso do Redmine, esta relação pode ser encontrada através do 
seguinte endereço: 
https://Awww.redmine.org/projects/redmine/wiki/Changelog/. 


17.2 Como atualizar? 


Após definir que é o momento de atualizar o Redmine para uma 
versão mais recente, devemos seguir alguns passos para realizar a 
atualização. 


Conforme foi comentado no capítulo anterior, o processo de backup 
é uma das etapas necessárias, e talvez uma das mais importantes 
no momento de realizar a atualização do Redmine. Por isso, vamos 
considerar que o processo de backup já foi realizado, seguindo os 
passos já apresentados. 


Assim como no processo de backup, é importante que durante o 
processo de atualização o Redmine não seja utilizado. 


Obtendo a nova versão 


Para atualizar o Redmine, faça o download da versão desejada 
através do site oficial, dando preferência à versão estável mais 
recente: 


http://www.redmine.org/projects/redmine/wiki/Download/ 


Esta etapa é semelhante ao processo apresentado no capítulo 
Instalando o Redmine manualmente. 


Ajustando as configurações 


Descompacte os arquivos da versão em um novo diretório, e então 
altere o arquivo database.yml informando os dados de acesso ao 
banco de dados da versão anterior semelhante ao exemplo a seguir: 


production: 
adapter: mysql2 
database: redmine 
host: 127.0.0.1 
username: reduser 
password: senhadificil 
port: 3307 


Altere também o arquivo configuration.yml, mantendo as 
configurações de envio de e-mail e as demais existentes no arquivo 
configurarion.yml da versão anterior. 


Criando uma nova base de dados 


Uma outra forma de atualizar o Redmine é criar uma nova base de 
dados exclusiva para a nova versão e importar os dados da versão 
anterior. Esta forma é interessante caso você precise retornar para a 
versão anterior em caso de problemas. 


Caso queira uma base de dados exclusiva para a nova versão, siga 

os mesmos passos apresentados no capítulo Instalando o Redmine 

manualmente para criar a base de dados e adicionar as permissões 

ao usuário. No exemplo a seguir, criamos uma base de dados com o 
nome redmine v3 4: 


CREATE DATABASE redmine v3 4; 
GRANT ALL PRIVILEGES ON “redmine v3 4'.* TO 'reduser'(0'%' WITH GRANT 
OPTION; 


E então importe o arquivo de backup da base de dados para 
restaurar os dados: 


mysql -u reduser -p redmine v3 4 < backup.sql 


Neste caso, informe o nome desta nova base de dados no arquivo 
database.yml. 


production: 
adapter: mysql2 
database: redmine v3 4 
host: 127.0.0.1 
username: reduser 
password: senhadificil 
port: 3307 


17.3 Instalando a nova versão 


Após alterar as configurações necessárias, realize o processo de 
instalação da mesma forma que uma instalação manual, através do 
seguinte comando: 


bundle install --without development test rmagick 


Desta forma, todas as dependências das novas versões serão 
instaladas juntamente com o novo Redmine. 


Gerando uma nova chave de criptografia 


Assim como no processo de instalação, é importante gerar uma 
nova chave de criptografia, para garantir a segurança do sistema. 
Para isso, execute o mesmo comando utilizado no processo de 
instalação: 


bundle exec rake generate secret token 


17.4 Atualizando a base de dados 


Geralmente, com o surgimento de novas versões, se tornam 
necessários ajustes na estrutura de armazenamento dos dados do 
Redmine, fazendo com que sejam criadas novas tabelas e campos 
na base de dados. 


Por este motivo, precisamos atualizar a estrutura do banco de dados 
para se adequar à nova versão do sistema. Para fazer isso, basta 
executar o seguinte comando: 


bundle exec rake db:migrate RAILS ENV=production 


Após finalizar o processo de atualização da base de dados, basta 
reiniciar o Redmine para passar a utilizar a versão atualizada do 
sistema. 


17.5 Copiando imagens e anexos 


Como vimos no capítulo anterior, o diretório files contém as 
imagens e anexos adicionados ao Redmine. Por este motivo, é 
importante copiar os arquivos do diretório files do Redmine 
anterior, para o do novo Redmine. Desta forma, as imagens e 
anexos continuarão disponíveis na nova versão. 


17.6 Desativando a versão anterior 


Após realizar o processo de atualização, é importante garantir que a 
versão anterior não continue em execução. Por isso, verifique se 
não há nenhum serviço relacionado ao Redmine antigo com 
inicialização automática no sistema operacional. Caso encontre 
algo, desative-o. 


No caso do Windows, é possível verificar através do gerenciador de 
serviços (Iniciar > Executar: services.msc ). 


No exemplo a seguir, temos 2 serviços relacionados ao Redmine em 
execução automática: 


KO redmineThin1 (managed by WinServ) Em Execução Automático 
OA redmineThin2 (managed by WinServ) Em Execução Automático 
Figura 17.1: Exemplo de serviços do Redmine do Bitnami em execução. 


Basta clicar com o botão direito, acessar as propriedades e alterar o 


Tipo de inicialização para Desativado . 


Já no caso de sistemas derivados do Linux, podemos utilizar o 
comando a seguir para listar os serviços habilitados: 


service --status-all 


E então utilizar o comando para desabilitar o serviço: 


systemctl disable NOME DO SERVIÇO 
Conclusão 


É importante saber como e quando atualizar o seu sistema, para 
garantir que as evoluções do Redmine estejam presentes no seu 
ambiente quando sua equipe precisar. Inicialmente, este processo 
pode parecer complexo, porém, vale a pena manter um sistema 
como o Redmine atualizado, pois a cada versão ele traz melhorias 
que auxiliam e muito nos processos de gerenciamento de projetos. 


No próximo capítulo veremos como personalizar o Redmine através 
da utilização de temas e plugins para atender a necessidades 
específicas. 


CAPÍTULO 18 
Melhorando o Redmine 


Apesar de o Redmine possuir uma série de ajustes por si só, como 
vimos nos capítulos anteriores, podemos melhorá-lo ainda mais com 
o uso de temas e plugins. O foco principal deste capítulo é 
apresentar estes dois itens. 


Digamos que você acha que a fonte padrão do Redmine é muito 
pequena, ou não gosta da aparência dos botões nos formulários. 
Para isso, podemos adicionar outros temas ao Redmine, ou então, 
criar o nosso próprio. 


E então, alguém da sua equipe precisa exportar a lista de tarefas 
para uma planilha do Excel. E para isso que existem os plugins, que 
são capazes de adicionar novas funcionalidades ao Redmine. 


18.1 Temas 


Como padrão, o Redmine possui 3 temas que podem ser alterados 
através do menu Administração > Configurações > Exibição . 
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Figura 18.1: Alteração de tema do Redmine. 


Basta escolher o tema e salvar as alterações, que o visual do 
Redmine será alterado para todos os usuários. 


Adicionando novos temas 


Para adicionar novos temas é muito simples. 


e Descompacte o tema no diretório public/themes ; 
e Reinicie o Redmine; 
e Altere o tema no menu Administração > Configurações > Exibição . 


No site oficial do Redmine há uma lista de temas para download: 


http://www.redmine.org/projects/redmine/wiki/Theme List/ 
Criando seus próprios temas 


Os temas do Redmine são desenvolvidos utilizando HTML, CSS e 
JavaScript, então, é necessário ter conhecimento básico em 
desenvolvimento Web para criar novos temas. 


Ao iniciar o Redmine, são analisados os temas existentes no 
diretório public/themes . Por isso, crie o seu tema neste diretório com 
letras minúsculas e sem caracteres especiais. 


O único arquivo que é obrigatório para que o seu tema seja 
carregado éo arquivo CSS stylesheets/application.css. 


Ao aplicar o seu tema, este arquivo é carregado automaticamente. 
Além disso, se existirem, serão carregados os seguintes arquivos: 


e Jjavascripts/theme.js (JavaScript) 
e favicon/favicon.ico (ícone de favorito) 


Para facilitar o entendimento, os diretórios de um tema seguem a 
seguinte estrutura: 
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Figura 18.2: Estrutura de temas do Redmine. 


Caso você queira criar um novo tema, é possível utilizar o tema 
base disponível no nosso GitHub para facilitar o processo: 


18.2 Plugins 


Quando a alteração desejada vai além de mudar a logo ou a cor da 
fonte do Redmine e precisamos adicionar novas funcionalidades 
que não existem na instalação padrão dele, precisamos utilizar 
plugins. 


Os plugins do Redmine são escritos em Ruby e ficam centralizados 
no diretório plugins na pasta principal do Redmine. 


Instalando um plugin 


Para instalar um plugin é necessário realizar os seguintes passos: 


e Descompacte o plugin no diretório de plugins. 
e Execute o comando para instalar o plugin (deve ser executado 
na pasta do Redmine): 


bundle exec rake redmine:plugins:migrate RAILS ENV=production 
e Reinicie o Redmine 


Existe uma série de plugins disponíveis para download no site oficial 
do Redmine: 


http://www .redmine.org/plugins/ 
Desinstalando um plugin 


Além de saber como instalar, é importante saber também como 
remover um plugin. Para realizar o processo de remoção de um 
plugin, precisamos realizar os seguintes passos: 


e Execute o comando de desinstalação (deve ser executado na 
pasta do Redmine): 


bundle exec rake redmine:plugins:migrate NAME=nome do plugin VERSION=0 
RAILS ENV=production 


e Remova o plugin da pasta de plugins. 
e Reinicie o Redmine. 


18.3 Desenvolvendo seus próprios plugins 


Caso você não encontre um plugin que atenda às necessidades da 
sua equipe, é possível criar um novo plugin, ou então editar um já 
existente, porém, exigirá um pouco de conhecimento de 
desenvolvimento com a linguagem Ruby, além de conhecimentos 
em HTML, CSS, JavaScript e modelagem de bancos de dados. Para 
exemplificar o funcionamento dos plugins, vamos criar um plugin 
simples para a criação de enquetes. 


A ideia é que, através do nosso plugin, sejam exibidas perguntas 
permitindo responder sim ou não, além de exibir o total de votos 
para cada uma das opções. 


Criando a estrutura inicial 


Para criarmos um plugin, podemos utilizar um gerador com os 
seguintes passos: 


Configure a variável de ambiente rarLs Env em sistemas Windows: 
set RAILS ENV=production 

Para outros sistemas execute o seguinte comando: 

export RAILS ENV="production" 


Para criar nosso plugin, podemos utilizar o comando de geração de 
plugins que utiliza o seguinte padrão: 


bundle exec ruby bin/rails generate redmine plugin nome do plugin 
No nosso exemplo, vamos chamar o plugin que enquete. 
bundle exec ruby bin/rails generate redmine plugin enquete 

O sistema retornará algo semelhante a estas mensagens: 


create plugins/enquete/app 
create plugins/enquete/app/controllers 


create 
create 
create 
create 
create 
create 
create 
create 
create 
create 
create 
create 
create 
create 
create 
create 
create 
create 
create 


plugins/enquete/app/helpers 
plugins/enquete/app/models 
plugins/enquete/app/views 
plugins/enquete/db/migrate 
plugins/enquete/lib/tasks 
plugins/enquete/assets/images 
plugins/enquete/assets/javascripts 
plugins/enquete/assets/stylesheets 
plugins/enquete/config/locales 
plugins/enquete/test 
plugins/enquete/test/fixtures 
plugins/enquete/test/unit 
plugins/enquete/test/functional 
plugins/enquete/test/integration 
plugins/enquete/README.rdoc 
plugins/enquete/init.rb 
plugins/enquete/config/routes.rb 
plugins/enquete/config/locales/en.yml 
plugins/enquete/test/test helper.rb 


Ao reiniciar o Redmine, acesse o menu administração > Plugins. 
Nesta tela você verá os plugins instalados, incluindo o plugin que 
você está criando: 


Plugins 


Enquete plugin 


This is a plugin for Redmine Author name 0.0.1 
http://example.com/path/to/plugin 


Verificar atualizações 


Figura 18.3: Lista de plugins instalados no Redmine. 


Para alterar as informações do plugin, você deve editar o arquivo 
init.rb gerado no diretório do plugin. 


O conteúdo dele será semelhante ao código a seguir: 


Redmine::Plugin.register :enquete do 
name 'Enquete plugin' 
author 'Author name' 
description “This is a plugin for Redmine' 
version '0.0.1' 
url "“http://example.com/path/to/plugin' 
author url "http://example.com/about' 

end 


Altere os campos trazendo mais informações sobre o plugin que 
você está criando. 


Criando a estrutura de banco de dados 


Até então nosso plugin não faz nada além de exibir informações na 
tela de plugins. Então precisamos criar uma tabela no banco de 
dados para armazenar suas informações. 


Para criar nosso modelo/tabela, podemos utilizar o seguinte padrão 
de comando: 


bundle exec ruby bin/rails generate redmine plugin model nome do plugin 
nome da tabela campoi:tipo:indice campo2:tipo 


No nosso caso, vamos precisar de uma estrutura para armazenar as 
perguntas da nossa enquete, contendo um texto com a pergunta, 
além de totalizadores para as opções sim € nao: 


bundle exec ruby bin/rails generate redmine plugin model enquete pergunta 
pergunta: string sim: integer nao: integer 


Este comando retornará as seguintes informações: 


create plugins/enquete/app/models/pergunta.rb 
create plugins/enquete/test/unit/pergunta test.rb 
create plugins/enquete/db/migrate/001 create pergunta.rb 


Podemos observar que o comando gerou o arquivo 
plugins/enquete/db/migrate/001 create pergunta.rb que será utilizado 
para criar a tabela no banco de dados. 


class CreatePergunta < ActiveRecord: :Migration 
def change 
create table :pergunta do |t| 
t.string :pergunta 
t.integer :sim 
t.integer :nao 
end 
end 
end 


Como este arquivo servirá de base para a criação da tabela, 
podemos fazer alterações nele para alterar a forma como a nossa 
tabela será criada. 


No nosso caso, é interessante que os totalizadores iniciem com a 
contagem zerada. Por isso, vamos definir o número ə como valor 
padrão para estes campos: 


t.integer :sim, :default => O 
t.integer :nao, :default => O 


Cada vez que um usuário selecionar uma das opções, o sistema 
deve aumentar os números armazenados nos campos sim e nao de 
acordo com a seleção do usuário. 


Por isso, vamos criar um método editando o arquivo 
plugins/enquete/app/models/pergunta.rb : 


class Pergunta < ActiveRecord: :Base 
unloadable 
end 


Substituiremos unloadable pelo nosso método votar , que receberá 
a resposta como parâmetro e incrementará o campo sim OU nao: 


class Pergunta < ActiveRecord: :Base 
def votar(resposta) 
increment(resposta == 'sim' ? :sim : :nao) 
end 
end 


Após criar e ajustar os arquivos de modelos você pode criar a 
estrutura executando o seguinte comando: 


bundle exec rake redmine:plugins:migrate 


Assim que as tabelas forem criadas, vamos adicionar umas 
perguntas por meio do console para realizar testes: 


bundle exec ruby bin/rails console 

Loading development environment (Rails 5.2.1) 

irb(main):001:0> Pergunta.create(: pergunta => "Você utiliza o Redmine no 
dia-a-dia?") 

>> Pergunta.create(:pergunta => "Seus projetos estão bem organizados?") 
>> exit 


Criando o primeiro controlador 


Para que o nosso plugin consiga utilizar a tabela que criamos no 
banco de dados, precisamos criar agora um controlador, no qual as 
funções do nosso plugin serão escritas. Para isso, utilizamos o 
seguinte padrão: 


bundle exec ruby bin/rails generate redmine plugin controller 
nome do plugin nome do controlador ações 


Desta forma, executando o comando a seguir, será criado o nosso 
primeiro controlador: 


bundle exec ruby bin/rails generate redmine plugin controller enquete 
perguntas listar votar 


Após criar o nosso controlador, precisamos implementar as duas 
ações que adicionamos, editando o arquivo 


plugins/enquete/app/controllers/perguntas controller.rb : 


class PerguntasController < ApplicationController 
def listar 
(perguntas = Pergunta.all 
end 


def votar 


pergunta = Pergunta.find(params[:id]) 
pergunta.votar(params[:resposta]) 
if pergunta.save 
flash[:notice] = 'Voto salvo com sucesso.' 
end 
redirect to :action => 'listar' 
end 
end 


Criando a visualização do nosso plugin 


De nada adianta termos uma tabela no banco de dados, uma lógica 
já implementada se não temos uma visualização. No nosso 
exemplo, vamos listar todas as perguntas, exibido o texto de cada 
uma delas, seguidas das opções sim e não, com o totalizador de 
cada uma delas no seguinte formato: 


Texto da primeira pergunta? Sim (0) / Não (0) 
Texto da segunda pergunta? Sim (0) / Não (0) 


Para conseguir este resultado, precisamos editar o arquivo 
plugins/enquete/app/views/perguntas/listar.html.erb da seguinte 
maneira: 


<h2>Perguntas</h2> 
<% (dperguntas.each do |pergunta| %> 

<p> 

<%= pergunta.pergunta %> 

<%= link to 'Sim', { :action => 'votar', :id => pergunta[:id], :resposta 
=> "sim" }, :method => :post %> (<%= pergunta.sim %>) / 

<%= link to 'Não', { :action => 'votar', :id => pergunta[:id], :resposta 
=> 'nao' }, :method => :post %> (<%= pergunta.nao %>) 

</p> 
<% end %> 


Adicionando rotas 


Agora, para que seja possível acessar o plugin que criamos, 
precisamos informar ao Redmine qual endereço deve acessar a 
nossa tela. 


Para isso adicionamos o seguinte conteúdo ao arquivo 


plugins/enquete/config/routes.rb : 


get 'perguntas', :to => 'perguntasklistar' 
post 'post/:id/votar', :to => 'perguntaskvotar' 


Desta forma, caso o seu Redmine esteja utilizando o endereço 
http://localhost/ , basta acessar o endereço 
http://localhost/perguntas para visualizar as perguntas. 


Adicionando nosso plugin ao menu 


Para que o usuário não precise informar o endereço exato do plugin 
criado, podemos adicioná-lo aos menus do sistema. Para isso, 
precisamos editar novamente o arquivo plugins/enquete/init.rb : 


Redmine::Plugin.register :enquete do 
name 'Enquete plugin' 
author 'Author name' 
description “This is a plugin for Redmine' 
version '0.0.1' 
url "“http://example.com/path/to/plugin' 
author url 'http://example.com/about' 


menu :top menu , :enquete, { :controller => 'perguntas', :action => 
'listar' }, :caption => 'Enquetes' 
end 


Observe que adicionamos o parâmetro top menu . Este primeiro 
parâmetro serve para indicar que o menu será adicionado ao menu 
superior esquerdo do Redmine 


Página inicial Projetos Enquetes Ajuda 


Redmine 





Pagina inicial 


Figura 18.4: Acesso ao plugin adicionado no menu principal do Redmine. 


As opções para determinar em qual menu o item será adicionado 
são as seguintes: 


Opção Menu 
account menu Menu superior direito. 
admin menu Menu de administração. 


nd Menu principal (quando o usuário não está 
application menu , 
em um projeto). 

top_menu Menu superior esquerdo. 


project_menu Menu principal de projetos. 


Os parâmetros seguintes servem para indicar qual ação do plugin 
será executada: 


menu :top_menu , :enquete, { :controller => 'perguntas', :action => 
'listar' }, :caption => 'Enquetes' 


No exemplo, será executada a ação 1istar do controlador perguntas 
do plugin enquete , utilizando a descrição Enquetes . 


Ao acessar o menu criado, serão exibidas as perguntas cadastradas 
que foram cadastradas através do console: 


Página inicial Minha página Projetos Administração Ajuda 


Redmine 





Projetos Atividade Tarefas Tempo gasto Gantt Calendário 


Perguntas 
Você utiliza o Redmine no dia-a-dia? Sim (0) / Não (0) 


Seus projetos estão bem organizados? Sim (0) / Não (0) 


Figura 18.5: Lista de perguntas 


Ao clicar em uma das opções, os votos serão contabilizados no 
banco de dados. 


Este é um exemplo básico para demonstrar como podemos criar 
plugins facilmente no Redmine. 


Os fontes deste plugin estão disponíveis no nosso GitHub: 


https://github.com/RedmineBR/redmine enquete/ 


18.4 Otimização 


Gerenciamento de logs 


Como vimos no capítulo Mantendo o Redmine seguro, os arquivos 
de logs são muito importantes para solucionar problemas eventuais. 


Porém, o armazenamento de logs pode causar outros problemas, 
como a ocupação de grande espaço em disco, elevado consumo de 
CPU e memória, além da dificuldade em encontrar erros. Por isso, é 
interessante adotar estratégias para a reduzir a quantidade de 
informações armazenadas nos logs. 


LogLevel 


Podemos configurar o Redmine para que grave apenas informações 
de erros e alertas nos logs. Para fazer isso, temos que realizar os 
seguintes passos: 


e Abra o diretório config do Redmine; 
e Crie um arquivo chamado additional environment.rb; 
e Adicione a seguinte linha: 


config.log level = :warn 


e Salve o arquivo. 
e Reinicie o Redmine. 


Desta forma, o Redmine não registrará todos os eventos do sistema 
e dos usuários, e gravará apenas as informações importantes para a 
resolução de possíveis problemas, fazendo com que esta seja uma 
configuração interessante para ser utilizada em ambientes de 
produção. 


Existem 6 tipos de configuração de nível de log: 


Log 


Função 
Level = 
unknown Registra erros inesperados. 


Registra erros do sistema que fazem com que o 


fatal f : 
sistema pare de funcionar. 


error Registra erros do sistema. 


warn Registra alertas do sistema. 


Log 


Função 
Level S 
o Registra informações gerais sobre as operações 
realizadas no sistema. 
aeoe Registra informações de baixo nível, contendo dados 


úteis para desenvolvedores. 


Os níveis de log seguem a ordem apresentada na tabela anterior, 
desta forma o nível de log debug é o nível que registra o maior 
número de informações, pois abrange também todos os outros tipos 
de log, enquanto o nível unknown é o que registra a menor 
quantidade de informações. 


Caso seja configurado o Log level para o nível error, por exemplo, 
serão registrados todos os logs do tipo error, fatal e unknown. Pois 
estes dois últimos também são considerados erros do sistema. 


Log Rotate 


Independente do nível de log configurado, o arquivo de registro de 
logs pode vir a ocupar um espaço considerável em disco com o 
passar do tempo. Neste caso, podemos configurar para que o 
Redmine elimine logs antigos ao gravar novos logs. 


Para isso, basta adicionar a seguinte linha ao arquivo 


additional_environment.rb : 


config.logger = Logger.new('log/arquivo.log', 2, 1048576) 


e O primeiro parâmetro ( 1og/arquivo.log ) serve para informar qual 
o local em que o arquivo será armazenado. 

e O segundo parâmetro ( 2 ) serve para indicar qual será o 
número máximo de arquivos de log. 

e Já o terceiro parâmetro (1.048.576 ) serve para informar qual 
será o tamanho do arquivo de log principal em bytes. 


18.5 Lembretes semanais 


Uma funcionalidade interessante no Redmine, mas que poucos 
administradores conhecem, é a possibilidade de envio de lembretes. 
Basicamente, serve para enviar e-mails para os usuários informando 
quais as atividades estão atribuídas para ele e ainda estão abertas. 


Para que sejam enviados os lembretes, é necessário executar o 
seguinte comando: 


bundle exec rake redmine:send reminders 


Este comando pode ser personalizado, aceitando as seguintes 
opções: 


e days : número de dias para verificar (padrão: próximos 7 dias); 
e tracker | código do tipo da tarefa; 

e project: código do projeto; 

e users : código do usuário ou usuários; 

e version: nome da versão. 


No exemplo a seguir, são enviados lembretes para o usuário de 
código 1, listando as tarefas em aberto e que estejam atribuídas a 
ele, com data prevista vencida, ou vencendo nos próximos 3 dias: 


bundle exec rake redmine:send reminders users='1" days='3' 
RAILS ENV="production" 


Para facilitar o processamento de envio de lembretes é possível 
criar scripts e adicioná-los ao agendamento do sistema operacional. 


No caso de sistemas Windows, é possível criar um arquivo com a 
extensão .bat com o seguinte conteúdo: 


:: Altere a linha a seguir pelo local da instalacao do Redmine 
cd C:\Redmine\ 
bundle exec rake redmine:send reminders ^ 

users='1' days='3' RAILS_ENV="production" 


Já para outros sistemas, é possível criar um shell script como no 
exemplo a seguir: 


#!/bin/bash 
# Altere a linha a seguir pelo local da instalacao do Redmine 
cd /opt/redmine 
bundle exec rake redmine:send_reminders \ 
users='1' days='3' RAILS_ENV="production" 


Adicione permissão de execução ao script: 


chmod +x script.sh 


E então, precisamos adicionar ao crontab, que serve para realizar o 
agendamento de tarefas no sistema operacional. Para utilizá-lo 
execute o comando crontab -e , adicionando a seguinte linha: 


# minuto hora dia mes dia-da-semana usuario script 
00 7 vi * root /caminho/do/script.sh 


No exemplo anterior, o script é executado todo dia às 7 horas da 
manhã, enviando a lista de tarefas pendentes por e-mail. Altere a 
configuração do crontab definindo um outro horário ou usuário de 
acordo com suas necessidades. 


Conclusão 


Agora que vimos como personalizar o Redmine, utilizando temas e 
plugins, podemos alterá-lo de diversas maneiras, permitindo que 
sejam adicionadas outras funcionalidades para ele assumir funções 
diferentes, se desejarmos. 


Podemos ainda anexar outras funcionalidades ao Redmine através 
de ferramentas externas. Este será o foco do nosso próximo 
capítulo, em que analisaremos algumas configurações e integrações 
possíveis do Redmine. 


CAPÍTULO 19 
Integrando o Redmine a outros serviços 


Neste capítulo, vamos explorar algumas maneiras diferentes de 
expandir o uso do Redmine. Veremos como integrá-lo a outros 
serviços externos, permitindo a troca de informação com eles. 


19.1 Active Directory / LDAP 


Imagine que na empresa Mina Vermelha Sistemas (ou na sua 
empresa) cada funcionário tem um usuário e senha que permite o 
acesso ao sistema operacional, à rede e outros sistemas. Tudo isso 
é feito através de um serviço chamado Microsoft Active Directory 
(AD), que se trata de uma base de usuários e outras informações 
que são disponibilizadas através da rede utilizando o protocolo de 
aplicação LDAP. Além do Active Directory existem outros serviços 
semelhantes como o OpenLDAP, por exemplo. 


Quando já existe uma base de usuários centralizada através da rede 
como o Active Directory, é interessante que outros serviços possam 
utilizar estes dados para autenticação. Por isso, vamos ver as 
opções de configuração para que o Redmine utilize o protocolo 
LDAP para consultar os dados de serviços de diretório como o 
Active Directory. 


Basicamente, a ideia é que o Redmine realize consultas utilizando o 
protocolo LDAP no processo de autenticação, tornando 
desnecessário o cadastro de novos usuários no sistema, além de 
manter as informações (como senhas) centralizadas no Active 
Directory ou outro serviço de diretório. 


Para realizar esta integração, precisaremos das seguintes 
informações: 


e Endereço do servidor. 

e Se utiliza criptografia SSL (LDAPS). 

e Porta de acesso, que geralmente é a 389 em conexões sem 
SSL, ou a 636 quando utiliza SSL. 

e Nome distinto (Distinguished Name - DN) para consulta ao 
servidor de diretório. 

e Campo correspondente ao nome de usuário. 

e Usuário e senha com acesso de leitura no diretório de usuários, 
pois geralmente os servidores LDAP não permitem a listagem 
de usuários sem autenticação por questão de segurança. 


Você pode conseguir estas informações com o administrador da sua 
rede (caso não seja você). 


DICA: DESCOBRINDO O CAMPO BASE DN! 


No caso de sistemas Windows, caso o usuário já esteja 
autenticado através de um domínio de rede, é possível executar 
o seguinte comando no terminal: 


whoami /fqdn 


Ele deverá retornar a string completa relacionada à conta do 
usuário logado no Windows, como no exemplo a seguir: 


cn=ldapuser, ou=users,dc=ldap, dc=minavermelha, dc=f00 


Esta informação pode então ser utilizada no momento de 
configurar, como veremos no exemplo a seguir. 





Para utilizar um servidor LDAP como modo de autenticação no 
Redmine, acesse o menu administração > Autenticação LDAP € clique 


em Novo modo de autenticação . 


Preencha os campos de acordo com as informações do servidor 
LDAP que deseja utilizar. 


Modos de autenticação » Novo modo de autenticação (LDAP) 





Nome * | DAP Mina Vermelha 











Servidor * |idap minavermelha f00 











Porta * |636 LDAPS (sem verificação de certificado) v 


E recomendado utilizar uma conexão LDAPS criptografada com verificação de 














certif 


cado para evitar qualquer manipulação durante o processo de autenticação 





Conta |cn=Idapuser ou=users dc=Idap.dc=minavermelha, dc=f00 | 








Senha |.ceccosses 











DN Base * |ou=users dc=Idap,dc=minavermelha,dc=f00 








Filtro LDAP 


Tempo de espera (em 


segundos) 














Criar usuários |V 
dinamicamente ("on-the- 














fly") 
Atributos 
Atributo para nome de [yid 
usuário * 








Atributo para nome |givenName 








Atributo para sobrenome |sn 














Atributo para e-mail |mail 





Figura 19.1: Configurações do servidor LDAP. 


Nesta tela você terá algumas configurações além das informações 
básicas do servidor: 


e Nome: nome de identificação do servidor LDAP no Redmine, 
pois poderão ser adicionados vários servidores. 

e Criar usuários dinamicamente ("on-the-fly"): permite que um 
usuário seja criado no Redmine ao realizar o acesso utilizando 
este servidor para autenticação. 

e Filtro LDAP: permite adicionar um filtro, para que seja possível 
apenas um grupo de usuários consiga acessar o sistema, por 
exemplo. 

e Tempo de espera: tempo que o Redmine aguardará pela 
resposta do servidor LDAP. 


e Atributo para nome: campo do nome do usuário no servidor 
LDAP. 
e Atributo para sobrenome: campo do sobrenome do usuário 
no servidor LDAP. 
e Atributo para e-mail: campo de e-mail do usuário no servidor 
LDAP. 


É importante observar que a maneira de informar o campo do 
usuário na configuração do LDAP no Redmine pode variar 
dependendo do serviço de diretório ( dominio.com\usuario , 


usuario@dominio.com OU uid=usuario,dc=dominio,dc=com geralmente). 


Após adicionar o servidor, clique em Testar para validar as 
configurações. Caso ocorra algum problema, verifique com o 
administrador da sua rede se as informações estão corretas, ou 
utilize algum programa que efetue consultas LDAP como o 
Idapsearch, ADExplorer ou LDAP Admin para tentar acessar o 
serviço. 


Como exemplo, temos a seguir um teste realizado com o LDAP 
Admin: 


cê AP Admin 


Start Edit 











A 





sê Conn General Options Attributes 


Pi 3 Connection: 
Fo Host: Idap.minavermelha.fDo Port: |636 Version: | 3 na 


Base: ou=users,dc=Idap,dc=minavermelha,dc=f00 Fetch DNs 


(0) Simple authentication ss. [Ons 
(O GS5-API 





























Account 





Username: cn=ldapuser ou=users 














Password: sesescscecass 











[L] Anonymous connection 


Figura 19.2: Start > Connections > New connection > Test connection. 


Basta informar os dados do serviço de diretório e verificar se é 
possível conectar. Caso não ocorra nenhum problema, agora será 
possível o acesso de usuários utilizando as contas existentes no 
servidor LDAP. 


Além disso, é possível fazer com que usuários já existentes no 
Redmine passem a utilizar o serviço LDAP para autenticar no 
sistema. 


Para isso, basta editar os usuários e selecionar o campo modo de 
Autenticação , que agora estará disponível para seleção: 


Usuários » neo 
Geral | Projetos 


Informações 





Usuário * Ineo 








Nome * |Thomas 


Sobrenome * |Anderson 











E-mail * Ineo(Dmatrix 








Idioma | Hebrew (nnay) bu 





Administrador || 


Autenticação 





Modo de autenticação | LDAP Mina Vermelha v 





Figura 19.3: Definindo que o usuário passará a utilizar o servidor LDAP. 


19.2 Chamados por e-mail 


Caso haja a necessidade de criar tarefas sem precisar acessar o 
Redmine diretamente, é possível criar chamados através de 
mensagens de e-mails, possibilitando a criação de tarefas por 
pessoas internas e externas sem usuários no Redmine. 


A primeira coisa que você deve fazer é definir qual será esta conta 
de e-mail que deve servir apenas para receber as mensagens e 
transformá-las em tarefas no sistema. Uma opção é criar um e-mail 


redmine@dominio.com OU suporte@dominio.com . 


Capturando as mensagens de e-mail 


A melhor forma de processar as mensagens recebidas por e-mail e 
fazer com que sejam criadas novas tarefas é através dos protocolos 
IMAP e POP3. São protocolos padrões de serviços de e-mails, logo 
garantem compatibilidade com a maioria dos cenários, além de não 
necessitar de configurações no servidor de e-mails. A principal 
diferença entre os dois é que o protocolo IMAP mantém as 
mensagens na caixa de entrada da conta de e-mail, enquanto, ao 
utilizar o protocolo POP3, as mensagens serão baixadas e 
removidas do servidor de e-mails por padrão. 


Para implementar essa funcionalidade, precisamos dos dados de 
acesso da conta de e-mail que receberá as mensagens, e configurar 
para que o sistema operacional analise as mensagens 
periodicamente. Esse intervalo entre as análises deve levar em 
conta os recursos do servidor e da rede, em paralelo ao número de 
e-mails esperado. 


O e-mail pode demorar 1 hora para se tornar uma tarefa no 
Redmine” Se não puder, é interessante definir um intervalo menor, 
como 5 ou 10 minutos, por exemplo, mas sempre levando em 
consideração os recursos de hardware disponíveis. 


Isso pode ser feito através de um arquivo .bat em sistemas 
Windows: 


:: Altere a linha a seguir pelo local da instalacao do Redmine 
cd C:NRedminel 
bundle exec rake redmine:email:receive imap ^ 
RAILS_ENV="production" ^ 
host="imap.minavermelha.foo" ^ 
port=993 ^ 
ssl=true ^ 
username="redmine(minavermelha.foo” ^ 
password="senhasecreta" ^ 
folder="INBOX" ^ 
project="identificador" 


Ou em shell script para outros sistemas: 


K!/bin/bash 
# Altere a linha a seguir pelo local da instalacao do Redmine 
cd /opt/redmine 
bundle exec rake redmine:email:receive imap À 
RAILS ENV="production" À 
host="imap.minavermelha.foo" N 
port=993 \ 
ssl=true N 
username="redmine(Qminavermelha.foo" À 
password="senhasecreta” N 
folder="INBOX" À 
project="identificador”" 


Caso queira utilizar o serviço POP3 no lugar de IMAP, substitua 
redmine:email:receive imap POF redmine:email:receive pop3. Além disso, 
substitua O host , port, ssl, folder, username € password de acordo 
com as configurações do seu servidor de e-mails. Já o parâmetro 
project deve corresponder ao identificador do projeto em que as 
tarefas devem ser criadas. 


Após criar os scripts, eles podem ser adicionados nos 
agendamentos do sistema operacional, semelhante à rotina de 
envio de lembretes apresentada no capítulo anterior. 


Ao realizar estes passos, as mensagens enviadas para a conta de 
e-mail, serão processadas periodicamente e serão transformadas 
em tarefa, utilizando o título do e-mail como título da tarefa, e o 
corpo do e-mail como descrição. 


Como funciona? 


Para demonstrar o funcionamento, vamos simular a criação de uma 
tarefa enviando um e-mail de exemplo: 


Q redmine@minavermelha.f00 x w 


De patrick@minavermelha. t00 


Problema no envio de e-mail 


Não estou conseguindo enviar e-mails... 
Espero que vocês recebam este aqui! 


Por favor, verifiquem com urgência este problema. 


Figura 19.4: Exemplo de criação de tarefa por e-mail. 


Assim que a rotina de captura de e-mails é executada, a tarefa é 
criada no Redmine, contendo a descrição que foi enviada por e-mail: 


Defeito #1 4 Editar Q} Tempo de trabalho Observar Copiar fi Excluir 


Problema no envio de e-mail 


Adicionado por Gerente dos Projetos menos de um minuto atrás. 


Situação: Nova Início: 01/04/2025 
Prioridade: Normal Data prevista: 
Atribuído para: - 9% Terminado: 0% 


Tempo estimado: 


Descrição O Responder 


Não estou conseguindo enviar e-mails... 
Espero que vocês recebam este aqui! 


Por favor, verifiquem com urgência este problema. 
Subtarefas ETOR 


Tarefas relacionadas Adicionar 


Figura 19.5: Tarefa criada por e-mail. 


É importante observar que, como padrão, é necessário que o 
endereço de e-mail de origem da mensagem corresponda a um 
usuário do Redmine, para que este seja definido como criador da 
tarefa. 


Este comportamento pode ser alterado adicionando o parâmetro 
unkonown user="accept" ao comando de importação de mensagens. 
Neste caso, as tarefas serão criadas de forma anônima quando não 
existir um usuário com o mesmo endereço de e-mail. 


19.3 Integrações via API 


Através da API do Redmine é possível realizar integrações capazes 
de gerenciar tarefas sem a utilização do Redmine propriamente dito. 
Tudo através do protocolo HTTP utilizando o padrão REST. 


Atualmente, várias informações podem ser recuperadas com a API 
nos formatos JSON e XML, que também permite a inserção de 
informações no sistema. 


Digamos que você precise capturar a lista das últimas tarefas 
incluídas no Redmine que você utiliza pelo endereço 
http: //minavermelha.foo/ . 


Para isso, basta realizar uma requisição HTTP para o endereço 
http://minavermelha.f00/issues.xml para retornar as tarefas em 
formato XML, OU http://minavermelha.fo0/issues.json para retornar em 
formato JSON. 


Estes dois endereços retornarão as tarefas iniciando pelas tarefas 
mais antigas. Caso queira retornar as tarefas em ordem 
decrescente, basta adicionar a string ?order=desc ao final da URL 
(exemplo: http://minavermelha.f00/issues.json*?order=desc ). 


Uma relação completa e atualizada dos métodos existentes na API 
do Redmine, incluindo o funcionamento de cada um deles, pode ser 
encontrada no seguinte endereço: 


http://www .redmine.org/projects/redmine/wiki/Rest api/ 


Com a API, podem ser criadas integrações com sistemas internos, 
fazendo com que os usuários não precisem cadastrar as mesmas 
informações em mais de um lugar, por exemplo. 


Conclusão 


Através destas formas de integração apresentadas neste capítulo, 
podemos fazer com que o Redmine funcione em conjunto com 
outras ferramentas de forma mais dinâmica facilitando o nosso dia a 
dia. 


Além disso, explorando a API, podem ser criadas outras maneiras 
de utilizar o Redmine, através de plugins no navegador, aplicativos 
para celular, entre outros. 


CAPÍTULO 20 
Capítulo final 


E chegamos ao capítulo final deste livro. Você se lembra de que, na 
introdução, propus que você revisasse os seus projetos para que 
neste ponto do livro você pudesse afirmar para si mesmo... 


Meus projetos estão bem organizados! 


Este era o objetivo que tinha em mente no momento que comecei a 
escrever este livro. Queria repassar todos os meus conhecimentos 
que adquiri utilizando o Redmine nos últimos anos, concentrados 
através de palavras e imagens para que outras pessoas pudessem 
utilizá-los para melhorar a forma de trabalhar no dia a dia. 


20.1 Próximos passos 


A ideia deste livro era trazer informações úteis sobre a utilização do 
Redmine de forma clara. Por isso, se você for um usuário avançado, 
talvez você sinta falta de alguma informação sobre o funcionamento 
do sistema em algum momento, já que o objetivo não era explicar o 
código interno, mas apresentar formas de gerenciar projetos com o 
Redmine da melhor forma possível. 


Então, caso você queira explorar mais o Redmine, e conhecer os 
seus segredos, você pode baixar o código-fonte dele, ler toda a 
documentação existente e inclusive sugerir novas funcionalidades 
através do site oficial: 


http://www.redmine.org/ 


E é claro que você pode também contribuir com o Redmine, criando 
plugins, temas, ajudando nas traduções e até na resolução de 


problemas. 
Conclusão final 


Espero ter atendido às suas expectativas, e que você se considere 
um especialista em Redmine a partir da leitura deste livro. Aproveite 
para participar dos nossos canais de comunicação apresentados na 
introdução do livro. 


Através da troca de experiências sobre a utilização do Redmine (ou 
qualquer outro assunto), é possível identificar outras formas de obter 
resultados semelhantes. Então, sinta-se à vontade para conversar 
com outros leitores e leitoras. 


Desejo a você sucesso na sua vida pessoal e profissional, e que 
você consiga manter seus projetos organizados da melhor maneira 
possível. 


Abraço, 


Patrick Kaminski 


